feat: add 'all' option to list process and user tasks to include completed instances

Author: vobu

src/commands/process-instances.ts

@@ -13,6 +13,7 @@ export async function listProcessInstances(options: {
   profile?: string;
   processDefinitionId?: string;
   state?: string;
+  all?: boolean;
 }): Promise<void> {
   const logger = getLogger();
   const client = createClient(options.profile);
@@ -31,6 +32,9 @@ export async function listProcessInstances(options: {
 
     if (options.state) {
       filter.filter.state = options.state;
+    } else if (!options.all) {
+      // By default, exclude COMPLETED instances unless --all is specified
+      filter.filter.state = 'ACTIVE';
     }
 
     const result = await client.searchProcessInstances(filter, { consistency: { waitUpToMs: 0 } });

src/commands/user-tasks.ts

@@ -13,6 +13,7 @@ export async function listUserTasks(options: {
   profile?: string;
   state?: string;
   assignee?: string;
+  all?: boolean;
 }): Promise<void> {
   const logger = getLogger();
   const client = createClient(options.profile);
@@ -27,6 +28,9 @@ export async function listUserTasks(options: {
 
     if (options.state) {
       filter.filter.state = options.state;
+    } else if (!options.all) {
+      // By default, exclude COMPLETED tasks unless --all is specified
+      filter.filter.state = 'CREATED';
     }
 
     if (options.assignee) {

src/index.ts

@@ -58,6 +58,7 @@ function parseCliArgs() {
       options: {
         help: { type: 'boolean', short: 'h' },
         version: { type: 'boolean', short: 'v' },
+        all: { type: 'boolean' },
         profile: { type: 'string' },
         bpmnProcessId: { type: 'string' },
         processInstanceKey: { type: 'string' },
@@ -235,6 +236,7 @@ async function main() {
       profile: values.profile as string | undefined,
       bpmnProcessId: values.bpmnProcessId as string | undefined,
       state: values.state as string | undefined,
+      all: values.all as boolean | undefined,
     });
     return;
   }
@@ -277,6 +279,7 @@ async function main() {
       profile: values.profile as string | undefined,
       state: values.state as string | undefined,
       assignee: values.assignee as string | undefined,
+      all: values.all as boolean | undefined,
     });
     return;
   }