current-cli 0.1.42__tar.gz → 0.1.44__tar.gz

{current_cli-0.1.42 → current_cli-0.1.44}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: current-cli
-Version: 0.1.42
+Version: 0.1.44
 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.42 → current_cli-0.1.44}/current_cli/schema.yml

@@ -2013,8 +2013,10 @@ paths:
             type: string
         description: Keep only projects whose current value matches, as 'key:value'
           (for example 'status:Active'). Repeat for more fields; repeating one key
-          accepts any of its values. An option matches by label, value, or ID. 'total'
-          counts the matching projects.
+          accepts any of its values. An option matches by label, value, or ID. Use
+          'key:*' for any value (is not blank) and 'key:!' for no value (is blank).
+          A number or date value may lead with '<', '<=', '>', or '>='; two bounds
+          on one key are a range. 'total' counts the matching projects.
       - in: query
         name: limit
         schema:
@@ -2093,12 +2095,29 @@ paths:
         Thumbs up/down (+ optional reason and comment) on a piece of platform
         output.
 
-        Reads are author-only: a member sees the reactions they gave, and never
-        anyone else's. Feedback on the platform's own output is candid only when
-        the member knows their colleagues are not reading it, and no surface
-        shows another member's reaction. Aggregate sentiment is a reporting
-        question, answered off the table directly rather than through this
-        endpoint.
+        Reads have two scopes, chosen by the ``scope`` query parameter:
+
+        - ``mine`` (the default) — the reactions the caller gave, and nobody
+          else's. This is what a plain member gets, whatever they ask for.
+        - ``workspace`` — every member's reactions, restricted to the workspaces
+          the caller is an admin of. A caller who administers no workspace reads
+          nothing under this scope; an admin of one workspace does not thereby
+          read a workspace where they are only a member.
+
+        Author-only is the default rather than the rule because the alternative
+        breaks the caller that exists. The portal reads this endpoint to draw a
+        member's own thumb (``getMyReaction``/``getMyReactions`` in
+        ``reactionsLogic.ts``) and takes the first row for a subject as "my
+        current reaction". Widening reads for admins by default would silently
+        make an admin's own widget show whichever teammate reacted last. An
+        explicit ``scope=workspace`` keeps that call path byte-for-byte
+        unchanged and makes reading a colleague's feedback a deliberate act.
+
+        A member is told this: feedback is private from their colleagues, but an
+        admin of their workspace can read it. That is a weaker promise than the
+        one this endpoint shipped with, and it is the honest one — an admin has
+        to be able to see whether the platform's output is any good, and the
+        alternative in practice was reading the production database.
 
         Create for any member of the workspace — every submission is a new row
         (see ``Reaction``). No update or delete: a changed mind is a new
@@ -2121,6 +2140,16 @@ paths:
         schema:
           type: string
         description: Filter by project UUID
+      - in: query
+        name: scope
+        schema:
+          type: string
+          enum:
+          - mine
+          - workspace
+        description: Whose reactions to read. 'mine' (the default) reads your own.
+          'workspace' reads every member's, and returns rows only from the workspaces
+          you are an admin of.
       - in: query
         name: subject_id
         schema:
@@ -2159,12 +2188,29 @@ paths:
         Thumbs up/down (+ optional reason and comment) on a piece of platform
         output.
 
-        Reads are author-only: a member sees the reactions they gave, and never
-        anyone else's. Feedback on the platform's own output is candid only when
-        the member knows their colleagues are not reading it, and no surface
-        shows another member's reaction. Aggregate sentiment is a reporting
-        question, answered off the table directly rather than through this
-        endpoint.
+        Reads have two scopes, chosen by the ``scope`` query parameter:
+
+        - ``mine`` (the default) — the reactions the caller gave, and nobody
+          else's. This is what a plain member gets, whatever they ask for.
+        - ``workspace`` — every member's reactions, restricted to the workspaces
+          the caller is an admin of. A caller who administers no workspace reads
+          nothing under this scope; an admin of one workspace does not thereby
+          read a workspace where they are only a member.
+
+        Author-only is the default rather than the rule because the alternative
+        breaks the caller that exists. The portal reads this endpoint to draw a
+        member's own thumb (``getMyReaction``/``getMyReactions`` in
+        ``reactionsLogic.ts``) and takes the first row for a subject as "my
+        current reaction". Widening reads for admins by default would silently
+        make an admin's own widget show whichever teammate reacted last. An
+        explicit ``scope=workspace`` keeps that call path byte-for-byte
+        unchanged and makes reading a colleague's feedback a deliberate act.
+
+        A member is told this: feedback is private from their colleagues, but an
+        admin of their workspace can read it. That is a weaker promise than the
+        one this endpoint shipped with, and it is the honest one — an admin has
+        to be able to see whether the platform's output is any good, and the
+        alternative in practice was reading the production database.
 
         Create for any member of the workspace — every submission is a new row
         (see ``Reaction``). No update or delete: a changed mind is a new
@@ -2200,12 +2246,29 @@ paths:
         Thumbs up/down (+ optional reason and comment) on a piece of platform
         output.
 
-        Reads are author-only: a member sees the reactions they gave, and never
-        anyone else's. Feedback on the platform's own output is candid only when
-        the member knows their colleagues are not reading it, and no surface
-        shows another member's reaction. Aggregate sentiment is a reporting
-        question, answered off the table directly rather than through this
-        endpoint.
+        Reads have two scopes, chosen by the ``scope`` query parameter:
+
+        - ``mine`` (the default) — the reactions the caller gave, and nobody
+          else's. This is what a plain member gets, whatever they ask for.
+        - ``workspace`` — every member's reactions, restricted to the workspaces
+          the caller is an admin of. A caller who administers no workspace reads
+          nothing under this scope; an admin of one workspace does not thereby
+          read a workspace where they are only a member.
+
+        Author-only is the default rather than the rule because the alternative
+        breaks the caller that exists. The portal reads this endpoint to draw a
+        member's own thumb (``getMyReaction``/``getMyReactions`` in
+        ``reactionsLogic.ts``) and takes the first row for a subject as "my
+        current reaction". Widening reads for admins by default would silently
+        make an admin's own widget show whichever teammate reacted last. An
+        explicit ``scope=workspace`` keeps that call path byte-for-byte
+        unchanged and makes reading a colleague's feedback a deliberate act.
+
+        A member is told this: feedback is private from their colleagues, but an
+        admin of their workspace can read it. That is a weaker promise than the
+        one this endpoint shipped with, and it is the honest one — an admin has
+        to be able to see whether the platform's output is any good, and the
+        alternative in practice was reading the production database.
 
         Create for any member of the workspace — every submission is a new row
         (see ``Reaction``). No update or delete: a changed mind is a new
@@ -2218,6 +2281,16 @@ paths:
           format: uuid
         description: A UUID string identifying this reaction.
         required: true
+      - in: query
+        name: scope
+        schema:
+          type: string
+          enum:
+          - mine
+          - workspace
+        description: Whose reactions to read. 'mine' (the default) reads your own.
+          'workspace' reads every member's, and returns rows only from the workspaces
+          you are an admin of.
       tags:
       - reactions
       security:

{current_cli-0.1.42 → current_cli-0.1.44}/llms.txt

@@ -682,7 +682,7 @@ GET /api/projects/projects/inventory/
 
 Options:
 - `--fields` - Field keys to keep; omit to return every current value
-- `--filter` - Keep only projects whose current value matches, as 'key:value' (for example 'status:Active'). Repeat for more fields; repeating one key accepts any of its values. An option matches by label, value, or ID. 'total' counts the matching projects.
+- `--filter` - Keep only projects whose current value matches, as 'key:value' (for example 'status:Active'). Repeat for more fields; repeating one key accepts any of its values. An option matches by label, value, or ID. Use 'key:*' for any value (is not blank) and 'key:!' for no value (is blank). A number or date value may lead with '<', '<=', '>', or '>='; two bounds on one key are a range. 'total' counts the matching projects.
 - `--limit` - Max projects per page (default 100, max 200)
 - `--offset` - Number of projects to skip (default 0)
 - `--values` - Read option values as labels (default) or as option IDs
@@ -758,12 +758,29 @@ Options:
 Thumbs up/down (+ optional reason and comment) on a piece of platform
 output.
 
-Reads are author-only: a member sees the reactions they gave, and never
-anyone else's. Feedback on the platform's own output is candid only when
-the member knows their colleagues are not reading it, and no surface
-shows another member's reaction. Aggregate sentiment is a reporting
-question, answered off the table directly rather than through this
-endpoint.
+Reads have two scopes, chosen by the ``scope`` query parameter:
+
+- ``mine`` (the default) — the reactions the caller gave, and nobody
+  else's. This is what a plain member gets, whatever they ask for.
+- ``workspace`` — every member's reactions, restricted to the workspaces
+  the caller is an admin of. A caller who administers no workspace reads
+  nothing under this scope; an admin of one workspace does not thereby
+  read a workspace where they are only a member.
+
+Author-only is the default rather than the rule because the alternative
+breaks the caller that exists. The portal reads this endpoint to draw a
+member's own thumb (``getMyReaction``/``getMyReactions`` in
+``reactionsLogic.ts``) and takes the first row for a subject as "my
+current reaction". Widening reads for admins by default would silently
+make an admin's own widget show whichever teammate reacted last. An
+explicit ``scope=workspace`` keeps that call path byte-for-byte
+unchanged and makes reading a colleague's feedback a deliberate act.
+
+A member is told this: feedback is private from their colleagues, but an
+admin of their workspace can read it. That is a weaker promise than the
+one this endpoint shipped with, and it is the honest one — an admin has
+to be able to see whether the platform's output is any good, and the
+alternative in practice was reading the production database.
 
 Create for any member of the workspace — every submission is a new row
 (see ``Reaction``). No update or delete: a changed mind is a new
@@ -779,12 +796,29 @@ Options:
 Thumbs up/down (+ optional reason and comment) on a piece of platform
 output.
 
-Reads are author-only: a member sees the reactions they gave, and never
-anyone else's. Feedback on the platform's own output is candid only when
-the member knows their colleagues are not reading it, and no surface
-shows another member's reaction. Aggregate sentiment is a reporting
-question, answered off the table directly rather than through this
-endpoint.
+Reads have two scopes, chosen by the ``scope`` query parameter:
+
+- ``mine`` (the default) — the reactions the caller gave, and nobody
+  else's. This is what a plain member gets, whatever they ask for.
+- ``workspace`` — every member's reactions, restricted to the workspaces
+  the caller is an admin of. A caller who administers no workspace reads
+  nothing under this scope; an admin of one workspace does not thereby
+  read a workspace where they are only a member.
+
+Author-only is the default rather than the rule because the alternative
+breaks the caller that exists. The portal reads this endpoint to draw a
+member's own thumb (``getMyReaction``/``getMyReactions`` in
+``reactionsLogic.ts``) and takes the first row for a subject as "my
+current reaction". Widening reads for admins by default would silently
+make an admin's own widget show whichever teammate reacted last. An
+explicit ``scope=workspace`` keeps that call path byte-for-byte
+unchanged and makes reading a colleague's feedback a deliberate act.
+
+A member is told this: feedback is private from their colleagues, but an
+admin of their workspace can read it. That is a weaker promise than the
+one this endpoint shipped with, and it is the honest one — an admin has
+to be able to see whether the platform's output is any good, and the
+alternative in practice was reading the production database.
 
 Create for any member of the workspace — every submission is a new row
 (see ``Reaction``). No update or delete: a changed mind is a new
@@ -796,6 +830,7 @@ Options:
 - `--limit` - Number of results to return per page.
 - `--offset` - The initial index from which to return the results.
 - `--project` - Filter by project UUID
+- `--scope` - Whose reactions to read. 'mine' (the default) reads your own. 'workspace' reads every member's, and returns rows only from the workspaces you are an admin of.
 - `--subject-id` - Filter by subject id
 - `--subject-type` - Filter by subject type
 - `--subject-version` - Filter by subject version
@@ -806,12 +841,29 @@ Options:
 Thumbs up/down (+ optional reason and comment) on a piece of platform
 output.
 
-Reads are author-only: a member sees the reactions they gave, and never
-anyone else's. Feedback on the platform's own output is candid only when
-the member knows their colleagues are not reading it, and no surface
-shows another member's reaction. Aggregate sentiment is a reporting
-question, answered off the table directly rather than through this
-endpoint.
+Reads have two scopes, chosen by the ``scope`` query parameter:
+
+- ``mine`` (the default) — the reactions the caller gave, and nobody
+  else's. This is what a plain member gets, whatever they ask for.
+- ``workspace`` — every member's reactions, restricted to the workspaces
+  the caller is an admin of. A caller who administers no workspace reads
+  nothing under this scope; an admin of one workspace does not thereby
+  read a workspace where they are only a member.
+
+Author-only is the default rather than the rule because the alternative
+breaks the caller that exists. The portal reads this endpoint to draw a
+member's own thumb (``getMyReaction``/``getMyReactions`` in
+``reactionsLogic.ts``) and takes the first row for a subject as "my
+current reaction". Widening reads for admins by default would silently
+make an admin's own widget show whichever teammate reacted last. An
+explicit ``scope=workspace`` keeps that call path byte-for-byte
+unchanged and makes reading a colleague's feedback a deliberate act.
+
+A member is told this: feedback is private from their colleagues, but an
+admin of their workspace can read it. That is a weaker promise than the
+one this endpoint shipped with, and it is the honest one — an admin has
+to be able to see whether the platform's output is any good, and the
+alternative in practice was reading the production database.
 
 Create for any member of the workspace — every submission is a new row
 (see ``Reaction``). No update or delete: a changed mind is a new
@@ -819,6 +871,9 @@ reaction, not an edit to the old one.
 
 GET /api/reactions/reactions/{id}/
 
+Options:
+- `--scope` - Whose reactions to read. 'mine' (the default) reads your own. 'workspace' reads every member's, and returns rows only from the workspaces you are an admin of.
+
 ### current tasks create
 
 The caller's personal todos. Incomplete tasks sort before completed ones.

{current_cli-0.1.42 → current_cli-0.1.44}/pyproject.toml

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