dailybot-cli 3.26.1__tar.gz → 3.27.0__tar.gz

{dailybot_cli-3.26.1 → dailybot_cli-3.27.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dailybot-cli
-Version: 3.26.1
+Version: 3.27.0
 Summary: Dailybot CLI - The command-line bridge between humans and agents. Progress reports, observability, and workflow automation for modern teams across Slack, Google Chat, Discord, MS Teams, and more.
 Author-email: Dailybot <support@dailybot.com>
 License: MIT

{dailybot_cli-3.26.1 → dailybot_cli-3.27.0}/dailybot_cli/api_client.py

@@ -2565,6 +2565,26 @@ class DailyBotClient:
         """DELETE /v1/plan/views/<uuid>/ — permanent."""
         return self._tasks_write("DELETE", f"views/{_path_segment(view_uuid)}/")
 
+    def list_workspace_views(self) -> Any:
+        """GET /v1/plan/views/workspace/ — personal + shared workspace views (person-only)."""
+        return self._tasks_read("views/workspace/")
+
+    def list_workspace_views_with_etag(self) -> tuple[Any, str | None]:
+        """GET /v1/plan/views/workspace/ plus the ETag a save must send back."""
+        return self._tasks_read_with_etag("views/workspace/")
+
+    def save_workspace_views(self, views: list[Any], *, if_match: str) -> Any:
+        """PUT /v1/plan/views/workspace/ — replaces the caller's WHOLE workspace view array.
+
+        Person-only. `If-Match` is required (412 stale, 428 absent).
+        """
+        return self._tasks_write(
+            "PUT",
+            "views/workspace/",
+            json=views,
+            headers={"If-Match": self._checked_if_match(if_match)},
+        )
+
     def list_board_mentionables(self, board_uuid: str) -> Any:
         """GET /v1/plan/boards/<uuid>/mentionables/ — who this viewer may @mention."""
         return self._tasks_read(f"boards/{_path_segment(board_uuid)}/mentionables/")
@@ -2981,6 +3001,78 @@ class DailyBotClient:
             "POST", f"boards/{_path_segment(board_uuid)}/states/reorder/", json={"order": order}
         )
 
+    def reorder_board(
+        self,
+        board_uuid: str,
+        *,
+        before: str | None = None,
+        after: str | None = None,
+        project: str | None = None,
+    ) -> Any:
+        """POST /v1/plan/boards/<uuid>/reorder/ — move among siblings or into another project.
+
+        Name ONE neighbour (`before` / `after`); both is `400 reorder_anchor_invalid`.
+        Neither moves the board last. `project` different from the current one MOVES
+        the board (milestones of tasks that belong to the old project are cleared).
+        """
+        payload: dict[str, Any] = {}
+        if before is not None:
+            payload["before"] = before
+        if after is not None:
+            payload["after"] = after
+        if project is not None:
+            payload["project"] = project
+        return self._tasks_write(
+            "POST", f"boards/{_path_segment(board_uuid)}/reorder/", json=payload
+        )
+
+    def board_move_preview(self, board_uuid: str, *, project: str) -> dict[str, Any]:
+        """GET /v1/plan/boards/<uuid>/move-preview/?project= — what a move would change.
+
+        Writes nothing. `project` is required.
+        """
+        return self._tasks_read(
+            f"boards/{_path_segment(board_uuid)}/move-preview/",
+            params={"project": project},
+        )
+
+    def update_board_member(self, board_uuid: str, user_uuid: str) -> Any:
+        """PATCH …/members/<user>/ — inspect the grant row (role is read-only).
+
+        An empty body returns the current membership. Sending `role` is `400`.
+        """
+        return self._tasks_write(
+            "PATCH",
+            f"boards/{_path_segment(board_uuid)}/members/{_path_segment(user_uuid)}/",
+            json={},
+        )
+
+    def create_board_view(
+        self,
+        board_uuid: str,
+        *,
+        name: str,
+        filters: dict[str, Any] | None = None,
+        idempotency_key: str | None = None,
+        **fields: Any,
+    ) -> Any:
+        """POST /v1/plan/boards/<uuid>/views/ — create one saved view (no If-Match).
+
+        Accepts an Idempotency-Key. Default visibility is personal.
+        """
+        payload: dict[str, Any] = {
+            "name": name,
+            "filters": filters if filters is not None else {},
+            **{k: v for k, v in fields.items() if v is not None},
+        }
+        return self._tasks_write(
+            "POST",
+            f"boards/{_path_segment(board_uuid)}/views/",
+            json=payload,
+            idempotent=True,
+            idempotency_key=idempotency_key,
+        )
+
     def add_board_member(
         self,
         board_uuid: str,
@@ -3021,6 +3113,29 @@ class DailyBotClient:
             "POST", f"boards/{_path_segment(board_uuid)}/labels/", json=payload
         )
 
+    def list_plan_labels(
+        self,
+        *,
+        search: str | None = None,
+        include_archived: bool = False,
+        **page: Any,
+    ) -> PaginatedResult:
+        """GET /v1/plan/labels/ — organization labels under the Plan taxonomy."""
+        params: dict[str, Any] = {}
+        if search:
+            params["search"] = search
+        if include_archived:
+            params["include_archived"] = "true"
+        return self._tasks_list("labels/", params=params or None, **page)
+
+    def create_plan_label(self, *, name: str, **fields: Any) -> Any:
+        """POST /v1/plan/labels/ — create an organization label (Plan surface)."""
+        payload: dict[str, Any] = {
+            "name": name,
+            **{k: v for k, v in fields.items() if v is not None},
+        }
+        return self._tasks_write("POST", "labels/", json=payload)
+
     def update_tasks_label(self, label_uuid: str, **fields: Any) -> dict[str, Any]:
         """PATCH /v1/plan/labels/<uuid>/ — name, color, description, is_archived."""
         payload: dict[str, Any] = {k: v for k, v in fields.items() if v is not None}
@@ -3132,6 +3247,14 @@ class DailyBotClient:
         """GET /v1/plan/tasks/ — strict about parameters; only declared ones."""
         return self._tasks_list("tasks/", params=filters, **page)
 
+    def get_tasks_board(self, *, filters: dict[str, Any] | None = None) -> dict[str, Any]:
+        """GET /v1/plan/tasks/board/ — grouped (optionally swimlaned) snapshot over a slice.
+
+        Flat-list filters apply; `group_by` / `sub_group_by` / `tasks_per_group` /
+        `offset` / `group` / `lane` control the grid. Not a paginated envelope.
+        """
+        return self._tasks_read("tasks/board/", params=filters)
+
     def get_task(self, task_uuid: str) -> dict[str, Any]:
         """GET /v1/plan/tasks/<uuid>/ — the most frequent call of all."""
         return self._tasks_read(f"tasks/{_path_segment(task_uuid)}/")
@@ -4223,6 +4346,61 @@ class DailyBotClient:
             "DELETE", f"projects/{_path_segment(project_uuid)}/members/{_path_segment(user_uuid)}/"
         )
 
+    def update_project_member(self, project_uuid: str, user_uuid: str) -> Any:
+        """PATCH …/members/<user>/ — inspect the grant row (role is read-only).
+
+        An empty body returns the current membership. Sending `role` is `400`.
+        """
+        return self._tasks_write(
+            "PATCH",
+            f"projects/{_path_segment(project_uuid)}/members/{_path_segment(user_uuid)}/",
+            json={},
+        )
+
+    def create_project_view(
+        self,
+        project_uuid: str,
+        *,
+        name: str,
+        filters: dict[str, Any] | None = None,
+        idempotency_key: str | None = None,
+        **fields: Any,
+    ) -> Any:
+        """POST /v1/plan/projects/<uuid>/views/ — create one saved view (no If-Match)."""
+        payload: dict[str, Any] = {
+            "name": name,
+            "filters": filters if filters is not None else {},
+            **{k: v for k, v in fields.items() if v is not None},
+        }
+        return self._tasks_write(
+            "POST",
+            f"projects/{_path_segment(project_uuid)}/views/",
+            json=payload,
+            idempotent=True,
+            idempotency_key=idempotency_key,
+        )
+
+    def reorder_project(
+        self,
+        project_uuid: str,
+        *,
+        before: str | None = None,
+        after: str | None = None,
+    ) -> Any:
+        """POST /v1/plan/projects/<uuid>/reorder/ — move in the shared workspace order.
+
+        Name ONE neighbour; both is `400 reorder_anchor_invalid`. Neither moves last.
+        Org-admin scope (`tasks:admin`).
+        """
+        payload: dict[str, Any] = {}
+        if before is not None:
+            payload["before"] = before
+        if after is not None:
+            payload["after"] = after
+        return self._tasks_write(
+            "POST", f"projects/{_path_segment(project_uuid)}/reorder/", json=payload
+        )
+
     def list_project_views_with_etag(self, project_uuid: str) -> tuple[Any, str | None]:
         """GET /v1/plan/projects/<uuid>/views/ plus the `ETag` a save must send back."""
         return self._tasks_read_with_etag(f"projects/{_path_segment(project_uuid)}/views/")

{dailybot_cli-3.26.1 → dailybot_cli-3.27.0}/dailybot_cli/commands/board.py

@@ -214,6 +214,19 @@ _MEMBER_COLUMNS: list[tuple[str, str, bool]] = [
     ("Role", "role", True),
     ("User UUID", "user.uuid", True),
 ]
+_MEMBER_DETAIL_FIELDS: list[tuple[str, str]] = [
+    ("UUID", "uuid"),
+    ("User UUID", "user_uuid"),
+    ("Team UUID", "team_uuid"),
+    ("Role", "role"),
+]
+_MOVE_PREVIEW_FIELDS: list[tuple[str, str]] = [
+    ("From project", "from_project_uuid"),
+    ("To project", "to_project_uuid"),
+    ("Tasks", "tasks_count"),
+    ("Foreign milestones", "tasks_with_foreign_milestone"),
+    ("Goals affected", "goals_affected"),
+]
 _LABEL_COLUMNS: list[tuple[str, str, bool]] = [
     ("Name", "name", False),
     ("Color", "color", True),
@@ -789,6 +802,34 @@ def board_member_remove(
     print_success("Member removed.")
 
 
+@board_member.command("update")
+@click.argument("board_uuid", metavar="BOARD")
+@click.argument("user_uuid", metavar="USER")
+@click.option("--json", "json_mode", is_flag=True, help="Emit machine-readable JSON to stdout.")
+def board_member_update(board_uuid: str, user_uuid: str, json_mode: bool) -> None:
+    """Inspect a board membership grant. Role is read-only (sending one is refused).
+
+    \b
+    An empty PATCH returns the current grant row. Board membership has no role
+    column — org roles plus board visibility are the access model.
+
+    \b
+    Examples:
+      dailybot plan board member update <board-uuid> <user-uuid>
+      dailybot plan board member update <board-uuid> <user-uuid> --json
+    """
+    client = require_auth()
+    try:
+        with console.status("Reading the membership..."):
+            data: dict[str, Any] = client.update_board_member(board_uuid, user_uuid)
+    except APIError as exc:
+        exit_for_tasks_error(exc, json_mode)
+    if json_mode:
+        emit_json(data)
+        return
+    print_tasks_detail_panel("Board member", data, _MEMBER_DETAIL_FIELDS)
+
+
 # ---------------------------------------------------------------------------
 # Labels and saved views — person-only writes
 # ---------------------------------------------------------------------------
@@ -935,6 +976,94 @@ def board_view() -> None:
     """
 
 
+@board_view.command("create")
+@click.argument("board_uuid", metavar="BOARD")
+@click.option("-n", "--name", required=True, help="View name (max 64).")
+@click.option(
+    "--view-mode",
+    default=None,
+    type=click.Choice(["list", "board", "kanban", "timeline", "calendar"], case_sensitive=False),
+    help="How the filtered set is drawn. `kanban` is accepted as an alias for `board`.",
+)
+@click.option("--group-by", default=None, help="Column dimension (state, owner, priority, …).")
+@click.option("--sub-group-by", default=None, help="Swimlane dimension, or `none`.")
+@click.option("--sort", default=None, help="Sort expression as the web app saves it.")
+@click.option(
+    "--visibility",
+    default=None,
+    type=click.Choice(["personal", "shared", "board_default"], case_sensitive=False),
+    help="Default personal. shared/board_default need tasks:admin.",
+)
+@click.option(
+    "-f",
+    "--filters-file",
+    type=click.File("r"),
+    default=None,
+    help="JSON object of filters (`-` reads stdin). Default empty object.",
+)
+@click.option("--idempotency-key", default=None, help="Reuse a key to make a retry safe.")
+@click.option("--json", "json_mode", is_flag=True, help="Emit machine-readable JSON to stdout.")
+def board_view_create(
+    board_uuid: str,
+    name: str,
+    view_mode: str | None,
+    group_by: str | None,
+    sub_group_by: str | None,
+    sort: str | None,
+    visibility: str | None,
+    filters_file: Any,
+    idempotency_key: str | None,
+    json_mode: bool,
+) -> None:
+    """Create one saved view on a board without replacing the whole list.
+
+    \b
+    No If-Match is required (unlike `view save`). Send --idempotency-key so a
+    retry cannot create a second view.
+
+    \b
+    Examples:
+      dailybot plan board view create <board-uuid> -n "My backlog" --view-mode board
+      dailybot plan board view create <board-uuid> -n Blocked -f filters.json --json
+    """
+    filters: dict[str, Any] = {}
+    if filters_file is not None:
+        try:
+            loaded: Any = load_json_input(filters_file)
+        except ValueError as exc:
+            raise click.BadParameter(f"not valid JSON: {exc}", param_hint="--filters-file") from exc
+        if not isinstance(loaded, dict):
+            raise click.BadParameter("must be a JSON object.", param_hint="--filters-file")
+        filters = loaded
+    fields: dict[str, Any] = {
+        k: v
+        for k, v in (
+            ("view_mode", view_mode),
+            ("group_by", group_by),
+            ("sub_group_by", sub_group_by),
+            ("sort", sort),
+            ("visibility", visibility),
+        )
+        if v is not None
+    }
+    client = require_auth()
+    try:
+        with console.status("Creating the view..."):
+            data: dict[str, Any] = client.create_board_view(
+                board_uuid,
+                name=name,
+                filters=filters,
+                idempotency_key=idempotency_key,
+                **fields,
+            )
+    except APIError as exc:
+        exit_for_tasks_error(exc, json_mode)
+    if json_mode:
+        emit_json(data)
+        return
+    report_write(data, f"Created view {named(data, name)}")
+
+
 @board_view.command("save")
 @click.argument("board_uuid", metavar="BOARD")
 @click.option(
@@ -1020,6 +1149,80 @@ def board_view_save(
     print_tasks_rows("Views", rows_of(data), _VIEW_COLUMNS, empty="No saved views.")
 
 
+@board.command("reorder")
+@click.argument("board_uuid", metavar="BOARD")
+@click.option(
+    "--before", default=None, help="Place this board immediately before this sibling board uuid."
+)
+@click.option(
+    "--after", default=None, help="Place this board immediately after this sibling board uuid."
+)
+@click.option(
+    "--project",
+    default=None,
+    help="Target project uuid. When different from the current one, the board is MOVED there.",
+)
+@click.option("--json", "json_mode", is_flag=True, help="Emit machine-readable JSON to stdout.")
+def board_reorder(
+    board_uuid: str,
+    before: str | None,
+    after: str | None,
+    project: str | None,
+    json_mode: bool,
+) -> None:
+    """Move a board among siblings, or into another project. Org admin / tasks:admin.
+
+    \b
+    Pass exactly one of --before or --after (or neither to move last). Both is
+    refused (`reorder_anchor_invalid`). Moving to another project clears milestones
+    on tasks that belonged only to the old project; the board key never changes.
+    Preview first with `board move-preview`.
+
+    \b
+    Examples:
+      dailybot plan board reorder <board-uuid> --after <other-board-uuid>
+      dailybot plan board reorder <board-uuid> --project <project-uuid> --before <board-uuid>
+    """
+    if before is not None and after is not None:
+        raise click.UsageError("Pass at most one of --before or --after.")
+    client = require_auth()
+    try:
+        with console.status("Reordering the board..."):
+            data: dict[str, Any] = client.reorder_board(
+                board_uuid, before=before, after=after, project=project
+            )
+    except APIError as exc:
+        exit_for_tasks_error(exc, json_mode)
+    if json_mode:
+        emit_json(data)
+        return
+    report_write(data, f"Reordered board {named(data, board_uuid)}")
+
+
+@board.command("move-preview")
+@click.argument("board_uuid", metavar="BOARD")
+@click.option("--project", required=True, help="Target project uuid to preview a move into.")
+@click.option("--json", "json_mode", is_flag=True, help="Emit machine-readable JSON to stdout.")
+def board_move_preview(board_uuid: str, project: str, json_mode: bool) -> None:
+    """Show what moving this board into another project would change. Writes nothing.
+
+    \b
+    Examples:
+      dailybot plan board move-preview <board-uuid> --project <project-uuid>
+      dailybot plan board move-preview <board-uuid> --project <project-uuid> --json
+    """
+    client = require_auth()
+    try:
+        with console.status("Building the move preview..."):
+            data: dict[str, Any] = client.board_move_preview(board_uuid, project=project)
+    except APIError as exc:
+        exit_for_tasks_error(exc, json_mode)
+    if json_mode:
+        emit_json(data)
+        return
+    print_tasks_detail_panel("Board move preview", data, _MOVE_PREVIEW_FIELDS)
+
+
 @board.command("snapshot")
 @click.argument("board_uuid", metavar="BOARD")
 @click.option("--sort", default=None, callback=parse_sort, help=SORT_HELP)

{dailybot_cli-3.26.1 → dailybot_cli-3.27.0}/dailybot_cli/commands/plan.py

@@ -1,13 +1,16 @@
 """`dailybot plan`: the one root of the Dailybot Plan command groups.
 
 Dailybot Plan (public API root ``/v1/plan/``). Its groups (``tasks``, ``task``, ``board``,
-``project``, ``goal``) are reachable only under this root, e.g. ``dailybot plan tasks routes list``.
+``project``, ``goal``, ``label``, ``views``) are reachable only under this root,
+e.g. ``dailybot plan tasks routes list``.
 """
 
 import click
 
 from dailybot_cli.commands.board import board
 from dailybot_cli.commands.goal import goal
+from dailybot_cli.commands.plan_label import label
+from dailybot_cli.commands.plan_views import views
 from dailybot_cli.commands.project import project
 from dailybot_cli.commands.task import task
 from dailybot_cli.commands.tasks import tasks
@@ -21,11 +24,11 @@ def plan() -> None:
     Every command lives under `dailybot plan`:
       dailybot plan tasks status
       dailybot plan task get ENG-142
-      dailybot plan board | project | goal ...
+      dailybot plan board | project | goal | label | views ...
     Notifications, routes, reports and the briefing live under the tasks group:
       dailybot plan tasks notifications get
     """
 
 
-for _group in (tasks, task, board, project, goal):
+for _group in (tasks, task, board, project, goal, label, views):
     plan.add_command(_group)