better-notion 2.0.1__tar.gz → 2.1.5__tar.gz

{better_notion-2.0.1 → better_notion-2.1.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: better-notion
-Version: 2.0.1
+Version: 2.1.5
 Summary: A high-level Python SDK for the Notion API with developer experience in mind.
 Project-URL: Homepage, https://github.com/nesalia-inc/better-notion
 Project-URL: Documentation, https://github.com/nesalia-inc/better-notion#readme

{better_notion-2.0.1 → better_notion-2.1.5}/better_notion/plugins/official/agents.py

@@ -910,8 +910,51 @@ class AgentsPlugin(CombinedPluginInterface):
             typer.echo(agents_cli.tasks_complete(task_id, actual_hours))
 
         @tasks_app.command("can-start")
-        def tasks_can_start_cmd(task_id: str):
-            typer.echo(agents_cli.tasks_can_start(task_id))
+        def tasks_can_start_cmd(
+            task_id: str,
+            explain: bool = typer.Option(False, "--explain", help="Show detailed explanation of blocking tasks")
+        ):
+            typer.echo(agents_cli.tasks_can_start(task_id, explain))
+
+        @tasks_app.command("deps")
+        def tasks_deps_cmd(task_id: str):
+            typer.echo(agents_cli.tasks_deps(task_id))
+
+        @tasks_app.command("ready")
+        def tasks_ready_cmd(
+            version_id: str = typer.Option(None, "--version-id", "-v", help="Filter by version ID")
+        ):
+            typer.echo(agents_cli.tasks_ready(version_id))
+
+        @tasks_app.command("assign")
+        def tasks_assign_cmd(
+            task_id: str,
+            to: str = typer.Option(..., "--to", help="Person to assign to")
+        ):
+            typer.echo(agents_cli.tasks_assign(task_id, to))
+
+        @tasks_app.command("unassign")
+        def tasks_unassign_cmd(task_id: str):
+            typer.echo(agents_cli.tasks_unassign(task_id))
+
+        @tasks_app.command("reassign")
+        def tasks_reassign_cmd(
+            task_id: str,
+            from_: str = typer.Option(..., "--from", help="Current assignee (for validation)"),
+            to: str = typer.Option(..., "--to", help="New assignee")
+        ):
+            typer.echo(agents_cli.tasks_reassign(task_id, from_, to))
+
+        @tasks_app.command("list-by-assignee")
+        def tasks_list_by_assignee_cmd(
+            assignee: str,
+            status: str = typer.Option(None, "--status", "-s", help="Filter by status")
+        ):
+            typer.echo(agents_cli.tasks_list_by_assignee(assignee, status))
+
+        @tasks_app.command("list-unassigned")
+        def tasks_list_unassigned_cmd():
+            typer.echo(agents_cli.tasks_list_unassigned())
 
         agents_app.add_typer(tasks_app)
 
@@ -997,6 +1040,10 @@ class AgentsPlugin(CombinedPluginInterface):
         def work_issues_blockers_cmd(project_id: str):
             typer.echo(agents_cli.work_issues_blockers(project_id))
 
+        @work_issues_app.command("list-blocked-by")
+        def work_issues_list_blocked_by_cmd(work_issue_id: str):
+            typer.echo(agents_cli.work_issues_list_blocked_by(work_issue_id))
+
         agents_app.add_typer(work_issues_app)
 
         # Incidents commands (under agents)
@@ -1041,6 +1088,21 @@ class AgentsPlugin(CombinedPluginInterface):
         def incidents_sla_violations_cmd():
             typer.echo(agents_cli.incidents_sla_violations())
 
+        @incidents_app.command("link-to-work-issue")
+        def incidents_link_to_work_issue_cmd(
+            incident_id: str,
+            work_issue_id: str
+        ):
+            typer.echo(agents_cli.incidents_link_to_work_issue(incident_id, work_issue_id))
+
+        @incidents_app.command("unlink-work-issue")
+        def incidents_unlink_work_issue_cmd(incident_id: str):
+            typer.echo(agents_cli.incidents_unlink_work_issue(incident_id))
+
+        @incidents_app.command("list-caused-by")
+        def incidents_list_caused_by_cmd(work_issue_id: str):
+            typer.echo(agents_cli.incidents_list_caused_by(work_issue_id))
+
         agents_app.add_typer(incidents_app)
 
     def register_sdk_models(self) -> dict[str, type]:

{better_notion-2.0.1 → better_notion-2.1.5}/better_notion/plugins/official/agents_cli.py

@@ -820,15 +820,17 @@ def tasks_complete(
     return asyncio.run(_complete())
 
 
-def tasks_can_start(task_id: str) -> str:
+def tasks_can_start(task_id: str, explain: bool = False) -> str:
     """
     Check if a task can start (all dependencies completed).
 
     Args:
         task_id: Task page ID
+        explain: Show detailed explanation of blocking tasks
 
     Example:
         $ notion tasks can-start task_123
+        $ notion tasks can-start task_123 --explain
     """
     async def _can_start() -> str:
         try:
@@ -837,33 +839,17 @@ def tasks_can_start(task_id: str) -> str:
             # Register SDK plugin
             register_agents_sdk_plugin(client)
 
-            # Get task and check
+            # Use manager method for detailed info
             manager = client.plugin_manager("tasks")
-            task = await manager.get(task_id)
-            can_start = await task.can_start()
-
-            if not can_start:
-                # Get incomplete dependencies
-                incomplete = []
-                for dep in await task.dependencies():
-                    if dep.status != "Completed":
-                        incomplete.append({
-                            "id": dep.id,
-                            "title": dep.title,
-                            "status": dep.status,
-                        })
+            result = await manager.can_start(task_id)
 
-                return format_success({
-                    "task_id": task.id,
-                    "can_start": False,
-                    "incomplete_dependencies": incomplete,
-                })
+            if explain and not result["can_start"]:
+                result["explanation"] = {
+                    "blocking_tasks": result["incomplete_dependencies"],
+                    "suggestion": "Wait for dependencies to complete before starting"
+                }
 
-            return format_success({
-                "task_id": task.id,
-                "can_start": True,
-                "message": "All dependencies are completed",
-            })
+            return format_success(result)
 
         except Exception as e:
             return format_error("CAN_START_ERROR", str(e), retry=False)
@@ -871,6 +857,248 @@ def tasks_can_start(task_id: str) -> str:
     return asyncio.run(_can_start())
 
 
+def tasks_deps(task_id: str) -> str:
+    """
+    List all dependencies of a task.
+
+    Args:
+        task_id: Task page ID
+
+    Example:
+        $ notion tasks deps task_123
+    """
+    async def _deps() -> str:
+        try:
+            client = get_client()
+
+            # Register SDK plugin
+            register_agents_sdk_plugin(client)
+
+            # Use manager method
+            manager = client.plugin_manager("tasks")
+            result = await manager.deps(task_id)
+
+            return format_success(result)
+
+        except Exception as e:
+            return format_error("DEPS_ERROR", str(e), retry=False)
+
+    return asyncio.run(_deps())
+
+
+def tasks_ready(version_id: Optional[str] = None) -> str:
+    """
+    List all tasks ready to start (dependencies completed).
+
+    Args:
+        version_id: Filter by version ID
+
+    Example:
+        $ notion tasks ready
+        $ notion tasks ready --version-id ver_123
+    """
+    async def _ready() -> str:
+        try:
+            client = get_client()
+
+            # Register SDK plugin
+            register_agents_sdk_plugin(client)
+
+            # Use manager method
+            manager = client.plugin_manager("tasks")
+            tasks = await manager.ready(version_id)
+
+            return format_success({
+                "ready_tasks": [
+                    {
+                        "id": task.id,
+                        "title": task.title,
+                        "status": task.status,
+                        "priority": task.priority,
+                    }
+                    for task in tasks
+                ],
+                "total": len(tasks)
+            })
+
+        except Exception as e:
+            return format_error("READY_ERROR", str(e), retry=False)
+
+    return asyncio.run(_ready())
+
+
+def tasks_assign(task_id: str, to: str) -> str:
+    """
+    Assign a task to a person.
+
+    Args:
+        task_id: Task page ID
+        to: Name of the person to assign to
+
+    Example:
+        $ notion tasks assign task_123 --to "Alice Chen"
+    """
+    async def _assign() -> str:
+        try:
+            client = get_client()
+
+            # Register SDK plugin
+            register_agents_sdk_plugin(client)
+
+            # Use manager method
+            manager = client.plugin_manager("tasks")
+            result = await manager.assign(task_id, to)
+
+            return format_success(result)
+
+        except Exception as e:
+            return format_error("ASSIGN_ERROR", str(e), retry=False)
+
+    return asyncio.run(_assign())
+
+
+def tasks_unassign(task_id: str) -> str:
+    """
+    Unassign a task.
+
+    Args:
+        task_id: Task page ID
+
+    Example:
+        $ notion tasks unassign task_123
+    """
+    async def _unassign() -> str:
+        try:
+            client = get_client()
+
+            # Register SDK plugin
+            register_agents_sdk_plugin(client)
+
+            # Use manager method
+            manager = client.plugin_manager("tasks")
+            result = await manager.unassign(task_id)
+
+            return format_success(result)
+
+        except Exception as e:
+            return format_error("UNASSIGN_ERROR", str(e), retry=False)
+
+    return asyncio.run(_unassign())
+
+
+def tasks_reassign(task_id: str, from_: str, to: str) -> str:
+    """
+    Reassign a task from one person to another.
+
+    Args:
+        task_id: Task page ID
+        from_: Current assignee (for validation)
+        to: New assignee
+
+    Example:
+        $ notion tasks reassign task_123 --from "Alice" --to "Bob"
+    """
+    async def _reassign() -> str:
+        try:
+            client = get_client()
+
+            # Register SDK plugin
+            register_agents_sdk_plugin(client)
+
+            # Use manager method
+            manager = client.plugin_manager("tasks")
+            result = await manager.reassign(task_id, from_, to)
+
+            return format_success(result)
+
+        except Exception as e:
+            return format_error("REASSIGN_ERROR", str(e), retry=False)
+
+    return asyncio.run(_reassign())
+
+
+def tasks_list_by_assignee(
+    assignee: str,
+    status: Optional[str] = None
+) -> str:
+    """
+    List tasks assigned to a person.
+
+    Args:
+        assignee: Name of the assignee
+        status: Optional status filter
+
+    Example:
+        $ notion tasks list-by-assignee "Alice Chen"
+        $ notion tasks list-by-assignee "Alice" --status "In Progress"
+    """
+    async def _list_by_assignee() -> str:
+        try:
+            client = get_client()
+
+            # Register SDK plugin
+            register_agents_sdk_plugin(client)
+
+            # Use manager method
+            manager = client.plugin_manager("tasks")
+            tasks = await manager.list_by_assignee(assignee, status)
+
+            return format_success({
+                "tasks": [
+                    {
+                        "id": task.id,
+                        "title": task.title,
+                        "status": task.status,
+                        "priority": task.priority,
+                    }
+                    for task in tasks
+                ],
+                "total": len(tasks)
+            })
+
+        except Exception as e:
+            return format_error("LIST_BY_ASSIGNEE_ERROR", str(e), retry=False)
+
+    return asyncio.run(_list_by_assignee())
+
+
+def tasks_list_unassigned() -> str:
+    """
+    List unassigned tasks.
+
+    Example:
+        $ notion tasks list-unassigned
+    """
+    async def _list_unassigned() -> str:
+        try:
+            client = get_client()
+
+            # Register SDK plugin
+            register_agents_sdk_plugin(client)
+
+            # Use manager method
+            manager = client.plugin_manager("tasks")
+            tasks = await manager.list_unassigned()
+
+            return format_success({
+                "unassigned_tasks": [
+                    {
+                        "id": task.id,
+                        "title": task.title,
+                        "status": task.status,
+                        "priority": task.priority,
+                    }
+                    for task in tasks
+                ],
+                "total": len(tasks)
+            })
+
+        except Exception as e:
+            return format_error("LIST_UNASSIGNED_ERROR", str(e), retry=False)
+
+    return asyncio.run(_list_unassigned())
+
+
 # ===== IDEAS =====
 
 def ideas_list(
@@ -1432,6 +1660,46 @@ def work_issues_blockers(project_id: str) -> str:
     return asyncio.run(_blockers())
 
 
+def work_issues_list_blocked_by(work_issue_id: str) -> str:
+    """
+    List tasks blocked by a work issue.
+
+    Args:
+        work_issue_id: Work issue page ID
+
+    Example:
+        $ notion work-issues list-blocked-by issue_456
+    """
+    async def _list_blocked_by() -> str:
+        try:
+            client = get_client()
+
+            # Register SDK plugin
+            register_agents_sdk_plugin(client)
+
+            # Use manager method
+            manager = client.plugin_manager("work_issues")
+            tasks = await manager.list_blocked_by(work_issue_id)
+
+            return format_success({
+                "blocked_tasks": [
+                    {
+                        "id": task.id,
+                        "title": task.title,
+                        "status": task.status,
+                        "priority": task.priority,
+                    }
+                    for task in tasks
+                ],
+                "total": len(tasks)
+            })
+
+        except Exception as e:
+            return format_error("LIST_BLOCKED_BY_ERROR", str(e), retry=False)
+
+    return asyncio.run(_list_blocked_by())
+
+
 # ===== INCIDENTS =====
 
 def incidents_list(
@@ -1726,3 +1994,102 @@ def incidents_sla_violations() -> str:
             return format_error("SLA_VIOLATIONS_ERROR", str(e), retry=False)
 
     return asyncio.run(_sla_violations())
+
+
+def incidents_link_to_work_issue(incident_id: str, work_issue_id: str) -> str:
+    """
+    Link an incident to a work issue (root cause).
+
+    Args:
+        incident_id: Incident page ID
+        work_issue_id: Work issue page ID
+
+    Example:
+        $ notion incidents link-to-work-issue inc_123 issue_456
+    """
+    async def _link_to_work_issue() -> str:
+        try:
+            client = get_client()
+
+            # Register SDK plugin
+            register_agents_sdk_plugin(client)
+
+            # Use manager method
+            manager = client.plugin_manager("incidents")
+            result = await manager.link_to_work_issue(incident_id, work_issue_id)
+
+            return format_success(result)
+
+        except Exception as e:
+            return format_error("LINK_TO_WORK_ISSUE_ERROR", str(e), retry=False)
+
+    return asyncio.run(_link_to_work_issue())
+
+
+def incidents_unlink_work_issue(incident_id: str) -> str:
+    """
+    Unlink an incident from its work issue.
+
+    Args:
+        incident_id: Incident page ID
+
+    Example:
+        $ notion incidents unlink-work-issue inc_123
+    """
+    async def _unlink_work_issue() -> str:
+        try:
+            client = get_client()
+
+            # Register SDK plugin
+            register_agents_sdk_plugin(client)
+
+            # Use manager method
+            manager = client.plugin_manager("incidents")
+            result = await manager.unlink_work_issue(incident_id)
+
+            return format_success(result)
+
+        except Exception as e:
+            return format_error("UNLINK_WORK_ISSUE_ERROR", str(e), retry=False)
+
+    return asyncio.run(_unlink_work_issue())
+
+
+def incidents_list_caused_by(work_issue_id: str) -> str:
+    """
+    List all incidents caused by a work issue.
+
+    Args:
+        work_issue_id: Work issue page ID
+
+    Example:
+        $ notion incidents list-caused-by issue_456
+    """
+    async def _list_caused_by() -> str:
+        try:
+            client = get_client()
+
+            # Register SDK plugin
+            register_agents_sdk_plugin(client)
+
+            # Use manager method
+            manager = client.plugin_manager("incidents")
+            incidents = await manager.list_caused_by(work_issue_id)
+
+            return format_success({
+                "incidents": [
+                    {
+                        "id": incident.id,
+                        "title": incident.title,
+                        "severity": incident.severity,
+                        "status": incident.status,
+                    }
+                    for incident in incidents
+                ],
+                "total": len(incidents)
+            })
+
+        except Exception as e:
+            return format_error("LIST_CAUSED_BY_ERROR", str(e), retry=False)
+
+    return asyncio.run(_list_caused_by())