current-cli 0.1.56__tar.gz → 0.1.57__tar.gz

{current_cli-0.1.56 → current_cli-0.1.57}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: current-cli
-Version: 0.1.56
+Version: 0.1.57
 Summary: Command line interface for the Current API, generated from its OpenAPI schema at runtime
 Author-email: Orin <your-email@example.com>
 License-Expression: MIT

{current_cli-0.1.56 → current_cli-0.1.57}/current_cli/schema.yml

@@ -2252,6 +2252,62 @@ paths:
               schema:
                 $ref: '#/components/schemas/Project'
           description: ''
+  /api/projects/projects/closeouts/:
+    get:
+      operationId: projects_projects_closeouts_retrieve
+      description: |-
+        Every project in the workspace that has a closeout review, worst
+        first then longest waiting.
+
+        Reads the cached summary on each project rather than the review
+        document itself, so one page is one query instead of one storage
+        read per row. The report still reads the document, which is why an
+        opened review is never stale even when this list is.
+      parameters:
+      - in: query
+        name: limit
+        schema:
+          type: integer
+        description: Max projects per page (default 50, max 200)
+      - in: query
+        name: offset
+        schema:
+          type: integer
+        description: Number of projects to skip (default 0)
+      - in: query
+        name: q
+        schema:
+          type: string
+        description: Keep only projects whose name contains this text, ignoring case
+      - in: query
+        name: status
+        schema:
+          type: string
+          enum:
+          - all
+          - clear
+          - pending
+        description: 'Which reviewed projects to keep: ''pending'' (default) for the
+          ones asking something of a person, ''clear'' for the rest, ''all'' for both.
+          A project with no closeout review is absent at every status.'
+      - in: query
+        name: workspace
+        schema:
+          type: string
+        description: Workspace UUID
+        required: true
+      tags:
+      - projects
+      security:
+      - MessagingJobTokenAuth: []
+      - tokenAuth: []
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/CloseoutQueueResponse'
+          description: ''
   /api/projects/projects/inventory/:
     get:
       operationId: projects_projects_inventory_retrieve
@@ -5086,6 +5142,53 @@ components:
       - client_secret
       - login_host
       - workspace
+    CloseoutQueueItem:
+      type: object
+      description: One project on a closeout queue page.
+      properties:
+        id:
+          type: string
+          format: uuid
+        name:
+          type: string
+        summary:
+          $ref: '#/components/schemas/CloseoutSummary'
+      required:
+      - id
+      - name
+      - summary
+    CloseoutQueueResponse:
+      type: object
+      description: |-
+        A page of reviewed projects, worst first then longest waiting.
+
+        ``pending`` and ``reviewed`` count the whole workspace rather than the
+        page, because the heading above the list speaks for the backlog and not
+        for what happens to fit on screen. ``next_offset`` is null on the last
+        page.
+      properties:
+        total:
+          type: integer
+        offset:
+          type: integer
+        next_offset:
+          type: integer
+          nullable: true
+        pending:
+          type: integer
+        reviewed:
+          type: integer
+        projects:
+          type: array
+          items:
+            $ref: '#/components/schemas/CloseoutQueueItem'
+      required:
+      - next_offset
+      - offset
+      - pending
+      - projects
+      - reviewed
+      - total
     CloseoutResponse:
       type: object
       description: |-
@@ -5097,6 +5200,59 @@ components:
           nullable: true
       required:
       - review
+    CloseoutSummary:
+      type: object
+      description: |-
+        The compact verdict the closeout queue reads, as
+        ``projects.closeout.build_summary`` writes it.
+
+        Every count is derived from the review document and cached on the
+        project; none of it is stored state a person can edit. ``error`` alone
+        is set when the stored review would not parse, and then the counts are
+        absent — a row that says the review is unreadable is more use than a
+        row that quietly disappears.
+      properties:
+        outcome:
+          type: string
+          nullable: true
+        open_outcome:
+          type: string
+          nullable: true
+        open:
+          type: integer
+        blockers:
+          type: integer
+        majors:
+          type: integer
+        minors:
+          type: integer
+        handled:
+          type: integer
+        satisfied:
+          type: integer
+        requirements_total:
+          type: integer
+        records_clear:
+          type: integer
+        records_total:
+          type: integer
+        blocking_records:
+          type: array
+          items:
+            type: string
+        files:
+          type: integer
+        reviewed_at:
+          type: string
+          nullable: true
+        requirements_version:
+          type: string
+          nullable: true
+        error:
+          type: string
+          nullable: true
+      required:
+      - outcome
     ColorEnum:
       enum:
       - neutral
@@ -5348,10 +5504,12 @@ components:
       enum:
       - activity
       - documents
+      - closeouts
       type: string
       description: |-
         * `activity` - Activity
         * `documents` - Documents
+        * `closeouts` - Closeouts
     DefinitionApplyRequest:
       type: object
       description: |-

{current_cli-0.1.56 → current_cli-0.1.57}/llms.txt

@@ -657,6 +657,25 @@ one yet.
 
 GET /api/projects/projects/{id}/closeout/
 
+### current projects closeouts retrieve
+
+Every project in the workspace that has a closeout review, worst
+first then longest waiting.
+
+Reads the cached summary on each project rather than the review
+document itself, so one page is one query instead of one storage
+read per row. The report still reads the document, which is why an
+opened review is never stale even when this list is.
+
+GET /api/projects/projects/closeouts/
+
+Options:
+- `--limit` - Max projects per page (default 50, max 200)
+- `--offset` - Number of projects to skip (default 0)
+- `--q` - Keep only projects whose name contains this text, ignoring case
+- `--status` - Which reviewed projects to keep: 'pending' (default) for the ones asking something of a person, 'clear' for the rest, 'all' for both. A project with no closeout review is absent at every status.
+- `--workspace` - Workspace UUID
+
 ### current projects create
 
 Projects across the caller's workspaces. Any member can create a

{current_cli-0.1.56 → current_cli-0.1.57}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "current-cli"
-version = "0.1.56"
+version = "0.1.57"
 description = "Command line interface for the Current API, generated from its OpenAPI schema at runtime"
 readme = "README.md"
 requires-python = ">=3.10"