hap-cli 0.5.0__py3-none-any.whl

hap_cli/commands/instance_cmd.py

@@ -0,0 +1,310 @@
+"""CLI commands for workflow instance and approval management."""
+
+import click
+
+from hap_cli.context import pass_context
+from hap_cli.core import instance as inst_mod
+from hap_cli.utils.formatting import output_json, output_table, output_kv
+
+
+@click.group()
+def instance():
+    """Workflow instance and approval management."""
+    pass
+
+
+@instance.command("todo-count")
+@pass_context
+def instance_todo_count(ctx):
+    """Get count of pending workflow tasks."""
+    try:
+        session = ctx.get_session()
+        data = inst_mod.get_todo_count(session)
+        ctx.output(data, lambda d: output_kv(d))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@instance.command("todo")
+@click.option("--type", "type_", default=-1, type=int,
+              help="Type: -1=all pending, 0=initiated, 3=fill, 4=approval, 5=view")
+@click.option("--keyword", "-k", default="", help="Search keyword")
+@click.option("--process-id", default="", help="Filter by process")
+@click.option("--page-size", "-n", default=20, help="Items per page")
+@click.option("--page", "-p", default=1, help="Page number")
+@pass_context
+def instance_todo(ctx, type_, keyword, process_id, page_size, page):
+    """List pending tasks (todo list)."""
+    try:
+        session = ctx.get_session()
+        result = inst_mod.get_todo_list(
+            session, page_index=page, page_size=page_size,
+            type_=type_, keyword=keyword, process_id=process_id,
+        )
+        ctx.output(
+            result,
+            lambda d: output_table(
+                d.get("data", []),
+                ["id", "title", "workId", "createDate"],
+                ["Instance ID", "Title", "Work ID", "Created"],
+            ),
+        )
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@instance.command("get")
+@click.argument("instance_id")
+@click.option("--work-id", "-w", default="", help="Work item ID")
+@pass_context
+def instance_get(ctx, instance_id, work_id):
+    """Get instance flow detail."""
+    try:
+        session = ctx.get_session()
+        data = inst_mod.get_instance_detail(session, instance_id, work_id)
+        ctx.output(data, lambda d: output_json(d))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@instance.command("operations")
+@click.argument("instance_id")
+@click.option("--work-id", "-w", default="", help="Work item ID")
+@pass_context
+def instance_operations(ctx, instance_id, work_id):
+    """Get available operations for a task."""
+    try:
+        session = ctx.get_session()
+        data = inst_mod.get_operation_detail(session, instance_id, work_id)
+        ctx.output(data, lambda d: output_json(d))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@instance.command("op-history")
+@click.argument("instance_id")
+@pass_context
+def instance_op_history(ctx, instance_id):
+    """Get operation history of an instance."""
+    try:
+        session = ctx.get_session()
+        data = inst_mod.get_operation_history(session, instance_id)
+        ctx.output(data, lambda d: output_json(d))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@instance.command("approve")
+@click.argument("instance_id")
+@click.option("--work-id", "-w", default="", help="Work item ID")
+@click.option("--opinion", "-o", default="", help="Approval comment")
+@pass_context
+def instance_approve(ctx, instance_id, work_id, opinion):
+    """Approve/pass a workflow task."""
+    try:
+        session = ctx.get_session()
+        data = inst_mod.approve(session, instance_id, work_id, opinion)
+        ctx.output(data, lambda d: click.echo("Approved."))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@instance.command("reject")
+@click.argument("instance_id")
+@click.option("--work-id", "-w", default="", help="Work item ID")
+@click.option("--opinion", "-o", default="", help="Rejection reason")
+@click.option("--back-to", default="", help="Node ID to return to")
+@pass_context
+def instance_reject(ctx, instance_id, work_id, opinion, back_to):
+    """Reject/overrule a workflow task."""
+    try:
+        session = ctx.get_session()
+        data = inst_mod.reject(
+            session, instance_id, work_id, opinion, back_node_id=back_to,
+        )
+        ctx.output(data, lambda d: click.echo("Rejected."))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@instance.command("forward")
+@click.argument("instance_id")
+@click.option("--to", "forward_to", required=True, help="Target user account ID")
+@click.option("--work-id", "-w", default="", help="Work item ID")
+@click.option("--opinion", "-o", default="", help="Forward comment")
+@pass_context
+def instance_forward(ctx, instance_id, forward_to, work_id, opinion):
+    """Forward a task to another user."""
+    try:
+        session = ctx.get_session()
+        data = inst_mod.forward(session, instance_id, forward_to, work_id, opinion)
+        ctx.output(data, lambda d: click.echo("Forwarded."))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@instance.command("sign")
+@click.argument("instance_id")
+@click.option("--to", "sign_to", required=True, help="Co-signer user ID")
+@click.option("--before/--after", default=True, help="Sign before or after current user")
+@click.option("--work-id", "-w", default="", help="Work item ID")
+@click.option("--opinion", "-o", default="", help="Comment")
+@pass_context
+def instance_sign(ctx, instance_id, sign_to, before, work_id, opinion):
+    """Add a co-signer to a task."""
+    try:
+        session = ctx.get_session()
+        data = inst_mod.sign_task(
+            session, instance_id, sign_to, before=before,
+            work_id=work_id, opinion=opinion,
+        )
+        ctx.output(data, lambda d: click.echo("Co-signer added."))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@instance.command("submit")
+@click.argument("instance_id")
+@click.option("--work-id", "-w", default="", help="Work item ID")
+@click.option("--opinion", "-o", default="", help="Submit comment")
+@pass_context
+def instance_submit(ctx, instance_id, work_id, opinion):
+    """Submit a fill-in task."""
+    try:
+        session = ctx.get_session()
+        data = inst_mod.submit(session, instance_id, work_id, opinion)
+        ctx.output(data, lambda d: click.echo("Submitted."))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@instance.command("revoke")
+@click.argument("instance_id")
+@click.option("--work-id", "-w", default="", help="Work item ID")
+@pass_context
+def instance_revoke(ctx, instance_id, work_id):
+    """Revoke/withdraw a submitted instance."""
+    try:
+        session = ctx.get_session()
+        data = inst_mod.revoke(session, instance_id, work_id)
+        ctx.output(data, lambda d: click.echo("Revoked."))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@instance.command("urge")
+@click.argument("instance_id")
+@click.option("--work-id", "-w", default="", help="Work item ID")
+@pass_context
+def instance_urge(ctx, instance_id, work_id):
+    """Send an urge/reminder for a pending task."""
+    try:
+        session = ctx.get_session()
+        data = inst_mod.urge(session, instance_id, work_id)
+        ctx.output(data, lambda d: click.echo("Urge sent."))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@instance.command("terminate")
+@click.argument("instance_id")
+@click.option("--yes", "-y", is_flag=True, help="Skip confirmation")
+@pass_context
+def instance_terminate(ctx, instance_id, yes):
+    """Terminate a running instance."""
+    try:
+        if not yes:
+            click.confirm(f"Terminate instance {instance_id}?", abort=True)
+        session = ctx.get_session()
+        data = inst_mod.end_instance(session, instance_id)
+        ctx.output(data, lambda d: click.echo("Instance terminated."))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@instance.command("retry")
+@click.argument("instance_id")
+@pass_context
+def instance_retry(ctx, instance_id):
+    """Retry a failed instance."""
+    try:
+        session = ctx.get_session()
+        data = inst_mod.reset_instance(session, instance_id)
+        ctx.output(data, lambda d: click.echo("Instance retried."))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@instance.command("restart")
+@click.argument("instance_id")
+@click.option("--work-id", "-w", default="", help="Work item ID")
+@pass_context
+def instance_restart(ctx, instance_id, work_id):
+    """Re-initiate a completed/rejected instance."""
+    try:
+        session = ctx.get_session()
+        data = inst_mod.restart_instance(session, instance_id, work_id)
+        ctx.output(data, lambda d: click.echo("Instance restarted."))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@instance.command("history")
+@click.option("--process-id", default="", help="Filter by process")
+@click.option("--status", "-s", default=0, type=int,
+              help="Status: 1=running, 2=completed, 3=rejected, 4=failed")
+@click.option("--keyword", "-k", default="", help="Title search")
+@click.option("--page-size", "-n", default=20, help="Items per page")
+@click.option("--page", "-p", default=1, help="Page number")
+@pass_context
+def instance_history(ctx, process_id, status, keyword, page_size, page):
+    """Get workflow execution history."""
+    try:
+        session = ctx.get_session()
+        result = inst_mod.get_history_list(
+            session, process_id=process_id, status=status,
+            title=keyword, page_index=page, page_size=page_size,
+        )
+        ctx.output(
+            result,
+            lambda d: output_table(
+                d.get("data", []),
+                ["instanceId", "title", "status", "createDate", "completeDate"],
+                ["Instance ID", "Title", "Status", "Created", "Completed"],
+            ),
+        )
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@instance.command("history-detail")
+@click.argument("instance_id")
+@pass_context
+def instance_history_detail(ctx, instance_id):
+    """Get execution history detail with node info."""
+    try:
+        session = ctx.get_session()
+        data = inst_mod.get_history_detail(session, instance_id)
+        ctx.output(data, lambda d: output_json(d))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@instance.command("batch")
+@click.option("--action", "-a", required=True, type=int, help="4=batch approve, 5=batch reject")
+@click.option("--type", "type_", default=-1, type=int, help="Task type filter")
+@click.option("--process-id", default="", help="Filter by process")
+@click.option("--select", "-s", multiple=True, help="Selected instance IDs")
+@pass_context
+def instance_batch(ctx, action, type_, process_id, select):
+    """Batch approve or reject tasks."""
+    try:
+        session = ctx.get_session()
+        data = inst_mod.batch_operation(
+            session, action,
+            type_=type_, process_id=process_id,
+            selects=list(select) if select else None,
+        )
+        ctx.output(data, lambda d: click.echo(f"Batch operation completed: {d}"))
+    except Exception as e:
+        ctx.handle_error(e)