@sanity/workflow-cli 0.30.0 → 0.32.0

package/CHANGELOG.md

@@ -1,5 +1,50 @@
 # @sanity/workflow-cli
 
+## 0.32.0
+
+### Minor Changes
+
+- a8ed312: **BREAKING:** Assignment is now one ordered user-or-role member-list model: a direct user holder shadows every role in the same activity, role-only values route work to a pool, and singular `assignee` fields allow at most one user while retaining any number of roles. The `claim` field and action sugars have been removed from the authoring DSL; authors using them must replace each pair with an `assignee` field, a literal role seed where the work starts in a pool, ordinary field edits for take/release, a guarded `editable` predicate when second-taker exclusion is required, and `$assigned` on holder-only actions. Definitions that still submit `type: 'claim'` now fail validation.
+
+  Upgrade every engine, Studio, CLI, MCP, and adapter runtime sharing a workflow resource before deploying a definition containing a singular `assignee`, then acknowledge reader model 9 on deployment. Existing model-8-and-earlier instances remain readable and keep their object/null singular representation; no stored-document backfill is required. Deploy now rejects project-role references absent from the target project's live role catalog and warns when a referenced role has no current human holder, so the deploying identity must be able to read the project role and member directories.
+
+  Studio assignment matching and holder explanations now follow direct-user shadowing. The CLI adds viewer-scoped assignment list flags and counts, MCP instance listing adds corresponding assignment inputs and counts, and the public waiting `Diagnosis` adds a required `waitingFor` discriminant that distinguishes caller-actionable, manual-but-unavailable, and automation waits without implying that unassigned work is freely actionable.
+
+  `@sanity/workflow-components` now exports `roleMemberCount`, which reports the distinct people who can fulfill any supplied project role using the workflow definition's aliases. Pass the current member directory, required role names, and normalized `roleAliases`; literal members and alias-only fulfillers are deduplicated by account-global user id. No upgrade action is required unless a custom assignment surface wants alias-aware pool sizes.
+
+  **Docs impact:** Update the assignment model and authoring references, the reader-model rollout guide, guarded role-pool and take/release examples, the `@sanity/workflow-components` member-selection reference for `roleMemberCount`, Studio task-holder explanations, CLI instance-list flags, MCP list tool reference, deploy role-validation requirements, and migration guidance from removed claim sugar.
+
+### Patch Changes
+
+- 8fc1f36: `@sanity/cli-core` is now a peer dependency, which reduces the install size of `@sanity/cli`
+
+  **No upgrade action required.** The peer dependency isn't marked optional, so package managers will still install it like normal.
+
+  **Docs impact:** None.
+
+- f1c9446: The CLI now formats timestamps with `@sanity/cli-core` instead of installing `date-fns`, reducing the standalone installation size while preserving absolute detail timestamps and relative list timestamps.
+
+  **No upgrade action required.** Relative timestamps use the runtime's standard English wording.
+
+  **Docs impact:** None. Timestamp presentation and CLI usage remain unchanged.
+
+- Updated dependencies [a8ed312]
+- Updated dependencies [2ba0c09]
+- Updated dependencies [2de38fd]
+- Updated dependencies [a2ce4a7]
+- Updated dependencies [2ddd3d7]
+- Updated dependencies [6035672]
+- Updated dependencies [26dd4e5]
+- Updated dependencies [b04580d]
+  - @sanity/workflow-engine@0.32.0
+
+## 0.31.0
+
+### Patch Changes
+
+- Updated dependencies [ff72ece]
+  - @sanity/workflow-engine@0.31.0
+
 ## 0.30.0
 
 ### Minor Changes

package/README.md

@@ -255,6 +255,6 @@ Mirrors the Sanity CLI's stack so the eventual plugin port is small:
 - `@oclif/plugin-help` for help output.
 - `ora`, `boxen`, `log-symbols`, `console-table-printer` for terminal UX;
   color comes from `node:util`'s `styleText` (no separate color dep).
-- `date-fns` for timestamp formatting (absolute for detail views, relative
+- `@sanity/cli-core` for timestamp formatting (absolute for detail views, relative
   "… ago" for list tables).
 - `diff` for the colored JSON unified diff in `deploy --dry-run`.

package/dist/commands/workflows/diagnose.js

@@ -1,5 +1,6 @@
 import { styleText } from 'node:util';
 import { Args } from '@oclif/core';
+import { formatDateTime } from '@sanity/cli-core/dates';
 import { diagnoseInputFromEvaluation, workflow, unsatisfiedTransitionSummaries, } from '@sanity/workflow-engine';
 import logSymbols from 'log-symbols';
 import { WorkflowCommand } from "../../lib/base-command.js";
@@ -7,7 +8,7 @@ import { resolveInstanceContext } from "../../lib/context.js";
 import { fail, failureDetail } from "../../lib/fail.js";
 import { instanceFlags, jsonFlags } from "../../lib/flags.js";
 import { baseEngineArgs } from "../../lib/operation-args.js";
-import { formatTimestamp, sectionHeader, activityIcon } from "../../lib/ui.js";
+import { sectionHeader, activityIcon } from "../../lib/ui.js";
 import { instanceHeader } from "./show.js";
 function formatAssignee(a) {
     return a.type === 'user' ? `user:${a.id}` : `role:${a.role}`;
@@ -45,7 +46,7 @@ function failedEffectDetail(effect) {
         headline: `a failed effect from action '${effect.origin.name}' is blocking its activity`,
         why: [
             styleText('red', `${logSymbols.error} failed effect: ${effect.name}`),
-            `  queued by action '${effect.origin.name}', failed ${formatTimestamp(effect.ranAt)}${ran}`,
+            `  queued by action '${effect.origin.name}', failed ${formatDateTime(effect.ranAt)}${ran}`,
             ...(effect.error !== undefined ? [`  error: ${effect.error.message}`] : []),
             '',
             `The activity that fired '${effect.origin.name}' is waiting on this effect. It failed`,
@@ -58,7 +59,7 @@ function hungEffectDetail(effect) {
         headline: `effect '${effect.name}' was claimed but never completed`,
         why: [
             styleText('yellow', `${logSymbols.warning} hung effect: ${effect.name}`),
-            `  claimed ${formatTimestamp(effect.claim?.claimedAt ?? '?')} but never reported back — the`,
+            `  claimed ${formatDateTime(effect.claim?.claimedAt ?? '?')} but never reported back — the`,
             `  drainer likely died mid-dispatch, so it won't drain on its own.`,
         ],
     };
@@ -74,22 +75,30 @@ function failedActivityDetail(activity) {
 }
 function waitingHeadline(w) {
     const who = w.assignees.length > 0 ? ` on ${w.assignees.map(formatAssignee).join(', ')}` : '';
-    if (w.actions.length === 0) {
+    if (w.waitingFor === 'automation') {
         return `waiting${who} on automation — a trigger fires on its own when its condition holds`;
     }
+    if (w.waitingFor === 'manual-action')
+        return `waiting${who} for an eligible caller to act`;
     return `waiting${who} for action: ${w.actions.join(' or ')}`;
 }
 function waitingLines(w) {
     const who = w.assignees.length > 0
         ? `assigned to ${w.assignees.map(formatAssignee).join(', ')}`
-        : 'unassigned — anyone with permission can act';
-    if (w.actions.length === 0) {
+        : 'unassigned — no holder is selected';
+    if (w.waitingFor === 'automation') {
         return [
             `${logSymbols.info} activity '${w.activity}' is active (${who}),`,
             `waiting on automation: its cascade-fired action(s) fire on their own when their`,
             `trigger conditions hold — nothing for a caller to fire.`,
         ];
     }
+    if (w.waitingFor === 'manual-action') {
+        return [
+            `${logSymbols.info} activity '${w.activity}' is active (${who}),`,
+            `waiting for a manual action, but none is available to this caller right now.`,
+        ];
+    }
     return [
         `${logSymbols.info} activity '${w.activity}' is active (${who}),`,
         `waiting for action: ${w.actions.join(' or ')}. This is the normal in-flight`,
@@ -163,10 +172,10 @@ function statusLine(diagnosis) {
         case 'blocked':
             return `${logSymbols.info} ${styleText('cyan', 'blocked')} — ${blockedHeadline(diagnosis)}`;
         case 'completed':
-            return `${logSymbols.success} ${styleText('green', 'completed')} at ${formatTimestamp(diagnosis.at)}.${liveChildrenTail(diagnosis)}`;
+            return `${logSymbols.success} ${styleText('green', 'completed')} at ${formatDateTime(diagnosis.at)}.${liveChildrenTail(diagnosis)}`;
         case 'aborted': {
             const tail = diagnosis.reason !== undefined ? ` — ${diagnosis.reason}` : '';
-            return `${logSymbols.info} ${styleText('dim', 'aborted')} at ${formatTimestamp(diagnosis.at)}${tail}.${liveChildrenTail(diagnosis)}`;
+            return `${logSymbols.info} ${styleText('dim', 'aborted')} at ${formatDateTime(diagnosis.at)}${tail}.${liveChildrenTail(diagnosis)}`;
         }
         case 'stuck':
             return `${logSymbols.warning} ${styleText('yellow', 'STUCK')} — ${causeDetail(diagnosis.cause).headline}`;

package/dist/commands/workflows/list.d.ts

@@ -1,4 +1,4 @@
-import { type GdrUri, type TerminalState } from '@sanity/workflow-engine';
+import { type AssignmentIdentity, type AssignmentStateCounts, type GdrUri, type StageEntry, type TerminalState } from '@sanity/workflow-engine';
 import { WorkflowCommand } from '../../lib/base-command.ts';
 interface InstanceRow {
     _id: string;
@@ -10,12 +10,16 @@ interface InstanceRow {
     lastChangedAt: string;
     modelVersion?: number | null;
     minReaderModel?: number | null;
+    stages?: StageEntry[];
 }
 interface ListFlags {
     'include-completed': boolean;
     failed: boolean;
     definition?: string | undefined;
     document?: string | undefined;
+    'assignment-user'?: string | undefined;
+    'assignment-role'?: string[] | undefined;
+    'assignment-state'?: string[] | undefined;
     tag?: string | undefined;
     limit: number;
 }
@@ -38,13 +42,14 @@ export declare function buildListQuery(flags: ListFlags): {
     params: Record<string, unknown>;
 };
 /** Map a queried instance to its display row (derives the status column). */
-export declare function instanceRow(r: InstanceRow): {
+export declare function instanceRow(r: InstanceRow, identity?: AssignmentIdentity): {
     _id: string;
     definition: string;
     tag: string;
     currentStage: string;
     status: TerminalState;
     lastChangedAt: string;
+    assignment?: AssignmentStateCounts;
 };
 export default class List extends WorkflowCommand {
     static description: string;
@@ -55,6 +60,9 @@ export default class List extends WorkflowCommand {
         failed: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         definition: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         document: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'assignment-user': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'assignment-role': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'assignment-state': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
         limit: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
         tag: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };

package/dist/commands/workflows/list.js

@@ -1,12 +1,13 @@
 import { Flags } from '@oclif/core';
-import { WORKFLOW_INSTANCE_TYPE, assertReadableModel, documentPrefilter, inFlightFilter, instanceWatchesDocument, tagScopeFilter, terminalState, } from '@sanity/workflow-engine';
+import { formatTimeAgo } from '@sanity/cli-core/dates';
+import { WORKFLOW_INSTANCE_TYPE, assignmentPrefilter, assertReadableModel, documentPrefilter, inFlightFilter, instanceWatchesDocument, instanceAssignmentStateCounts, tagScopeFilter, terminalState, } from '@sanity/workflow-engine';
 import logSymbols from 'log-symbols';
 import { WorkflowCommand } from "../../lib/base-command.js";
 import { resolveReadTargets } from "../../lib/context.js";
 import { failOnThrow } from "../../lib/fail.js";
 import { jsonFlags, tagFlags } from "../../lib/flags.js";
 import { logJsonListing, runReadAcrossTargets } from "../../lib/read-fanout.js";
-import { formatAge, logClippedTable } from "../../lib/ui.js";
+import { logClippedTable } from "../../lib/ui.js";
 const DOCUMENT_LIST_PROJECTION = `{
   _type,
   _id,
@@ -39,6 +40,12 @@ export function buildListQuery(flags) {
         filters.push(tagScopeFilter());
         params['tag'] = flags.tag;
     }
+    const assignment = assignmentFilter(flags);
+    if (assignment !== undefined) {
+        const armParams = {};
+        filters.push(assignmentPrefilter(assignment, armParams));
+        Object.assign(params, armParams);
+    }
     if (flags.document) {
         const armParams = {};
         filters.push(`(${documentPrefilter([flags.document], armParams)})`);
@@ -60,10 +67,28 @@ export function buildListQuery(flags) {
       lastChangedAt,
       modelVersion,
       minReaderModel
+      ${assignment === undefined ? '' : ', stages'}
     }`;
     return { groq, params };
 }
-export function instanceRow(r) {
+function assignmentFilter(flags) {
+    const userId = flags['assignment-user'];
+    const roles = flags['assignment-role'];
+    const rawStates = flags['assignment-state'];
+    if (userId === undefined) {
+        if (roles !== undefined || rawStates !== undefined) {
+            throw new Error('--assignment-role and --assignment-state require --assignment-user');
+        }
+        return undefined;
+    }
+    const states = rawStates;
+    return {
+        userId,
+        ...(roles === undefined ? {} : { roles }),
+        ...(states === undefined ? {} : { states }),
+    };
+}
+export function instanceRow(r, identity) {
     return {
         _id: r._id,
         definition: r.definition,
@@ -74,8 +99,57 @@ export function instanceRow(r) {
             ...(r.abortedAt != null ? { abortedAt: r.abortedAt } : {}),
         }),
         lastChangedAt: r.lastChangedAt,
+        ...(identity === undefined ? {} : { assignment: assignmentCounts(r, identity) }),
     };
 }
+function assignmentCounts(row, identity) {
+    return instanceAssignmentStateCounts({ currentStage: row.currentStage, stages: row.stages ?? [] }, identity);
+}
+function assignmentIdentityFor(flags) {
+    const assignment = assignmentFilter(flags);
+    return assignment === undefined
+        ? undefined
+        : { userId: assignment.userId, roles: assignment.roles ?? [] };
+}
+async function logTargetInstances(args) {
+    const fetched = await fetchRows(args);
+    if (fetched.rows.length === 0) {
+        const message = fetched.hasMore
+            ? `no matches in the first ${args.limit} candidates — raise --limit to search further`
+            : 'no instances match';
+        args.log(`${logSymbols.info} ${message}`);
+        return;
+    }
+    logClippedTable({
+        rows: fetched.rows,
+        limit: args.limit,
+        moreAvailable: fetched.hasMore,
+        headers: [
+            'instance',
+            'workflow',
+            'tag',
+            'stage',
+            'status',
+            'updated',
+            ...(args.identity === undefined ? [] : ['assignment u/r/h']),
+        ],
+        toCells: (candidate) => {
+            const row = instanceRow(candidate, args.identity);
+            return [
+                row._id,
+                row.definition,
+                row.tag,
+                row.currentStage,
+                row.status,
+                formatTimeAgo(new Date(row.lastChangedAt)),
+                ...(row.assignment === undefined
+                    ? []
+                    : [`${row.assignment.unrouted}/${row.assignment.routed}/${row.assignment.held}`]),
+            ];
+        },
+        log: args.log,
+    });
+}
 export default class List extends WorkflowCommand {
     static description = 'List workflow instances in the configured dataset (in-flight by default).';
     static examples = [
@@ -83,6 +157,7 @@ export default class List extends WorkflowCommand {
         '<%= config.bin %> workflows list --include-completed',
         '<%= config.bin %> workflows list --definition productLaunch',
         '<%= config.bin %> workflows list --document dataset:proj:ds:article-1',
+        '<%= config.bin %> workflows list --assignment-user gAda --assignment-role legal --assignment-state routed',
         '<%= config.bin %> workflows list --tag prod',
         '<%= config.bin %> workflows list --json',
     ];
@@ -103,6 +178,18 @@ export default class List extends WorkflowCommand {
             description: 'Only instances that reference this document (resource-qualified GDR URI, ' +
                 'e.g. "dataset:proj:ds:article-1").',
         }),
+        'assignment-user': Flags.string({
+            description: 'Account-global user id used for viewer-scoped assignment filtering and counts.',
+        }),
+        'assignment-role': Flags.string({
+            description: 'A literal project role held by --assignment-user. Repeat for multiple roles.',
+            multiple: true,
+        }),
+        'assignment-state': Flags.string({
+            description: 'Assignment state to include: unrouted, routed (offered through a supplied role), or held. Repeat for multiple states.',
+            multiple: true,
+            options: ['unrouted', 'routed', 'held'],
+        }),
         limit: Flags.integer({
             description: 'Maximum rows to return.',
             default: 50,
@@ -112,8 +199,9 @@ export default class List extends WorkflowCommand {
     async run() {
         const { flags } = await this.parse(List);
         const targets = await resolveReadTargets(flags);
-        const { groq, params } = failOnThrow('Invalid --document:', () => buildListQuery(flags));
+        const { groq, params } = failOnThrow('Invalid list filter:', () => buildListQuery(flags));
         const document = flags.document;
+        const identity = assignmentIdentityFor(flags);
         if (flags.json) {
             await logJsonListing({
                 targets,
@@ -121,43 +209,22 @@ export default class List extends WorkflowCommand {
                 limit: flags.limit,
                 log: (line) => this.log(line),
                 fetch: ({ client }) => fetchRows({ client, groq, params, document, limit: flags.limit }),
-                toRow: instanceRow,
+                toRow: (row) => instanceRow(row, identity),
             });
             return;
         }
         const failures = await runReadAcrossTargets({
             targets,
             log: (line) => this.log(line),
-            run: async ({ client }) => {
-                const fetched = await fetchRows({ client, groq, params, document, limit: flags.limit });
-                if (fetched.rows.length === 0) {
-                    if (fetched.hasMore) {
-                        this.log(`${logSymbols.info} no matches in the first ${flags.limit} candidates — raise --limit to search further`);
-                    }
-                    else {
-                        this.log(`${logSymbols.info} no instances match`);
-                    }
-                    return;
-                }
-                logClippedTable({
-                    rows: fetched.rows,
-                    limit: flags.limit,
-                    moreAvailable: fetched.hasMore,
-                    headers: ['instance', 'workflow', 'tag', 'stage', 'status', 'updated'],
-                    toCells: (r) => {
-                        const row = instanceRow(r);
-                        return [
-                            row._id,
-                            row.definition,
-                            row.tag,
-                            row.currentStage,
-                            row.status,
-                            formatAge(row.lastChangedAt),
-                        ];
-                    },
-                    log: (line) => this.log(line),
-                });
-            },
+            run: ({ client }) => logTargetInstances({
+                client,
+                groq,
+                params,
+                document,
+                limit: flags.limit,
+                identity,
+                log: (line) => this.log(line),
+            }),
         });
         if (failures.length > 0) {
             this.exit(1);

package/dist/commands/workflows/show.js

@@ -1,11 +1,12 @@
 import { styleText } from 'node:util';
 import { Args, Flags } from '@oclif/core';
+import { formatDateTime } from '@sanity/cli-core/dates';
 import { abortReason, displayTitle, terminalState, } from '@sanity/workflow-engine';
 import logSymbols from 'log-symbols';
 import { WorkflowCommand } from "../../lib/base-command.js";
 import { findInstance, resolveReadTargets } from "../../lib/context.js";
 import { jsonFlags, tagFlags } from "../../lib/flags.js";
-import { formatKeyValue, formatTimestamp, sectionHeader, activityIcon } from "../../lib/ui.js";
+import { formatKeyValue, sectionHeader, activityIcon } from "../../lib/ui.js";
 export default class Show extends WorkflowCommand {
     static description = 'Show the state, activities, and effects of a workflow instance.';
     static examples = [
@@ -55,16 +56,16 @@ export function instanceHeader(instance) {
     const title = `${styleText('bold', `${instance.definition} v${instance.pinnedVersion}`)}  ${styleText('cyan', instance._id)}`;
     const rows = [
         formatKeyValue({ key: 'Stage', value: instance.currentStage, padTo: HEADER_PAD }),
-        formatKeyValue({ key: 'Started', value: formatTimestamp(instance.startedAt), padTo: HEADER_PAD }),
+        formatKeyValue({ key: 'Started', value: formatDateTime(instance.startedAt), padTo: HEADER_PAD }),
     ];
     if (terminalState(instance) === 'aborted' && instance.abortedAt !== undefined) {
         const reason = abortReason(instance);
         const tail = reason ? ` — ${reason}` : '';
-        const value = `${formatTimestamp(instance.abortedAt)}${tail}`;
+        const value = `${formatDateTime(instance.abortedAt)}${tail}`;
         rows.push(formatKeyValue({ key: 'Aborted', value, padTo: HEADER_PAD, emphasis: 'yellow' }));
     }
     else if (instance.completedAt) {
-        const value = formatTimestamp(instance.completedAt);
+        const value = formatDateTime(instance.completedAt);
         rows.push(formatKeyValue({ key: 'Completed', value, padTo: HEADER_PAD, emphasis: 'green' }));
     }
     else {
@@ -92,7 +93,7 @@ function stageLines(instance) {
 }
 function stageMarker(stage) {
     return stage.exitedAt
-        ? styleText('dim', ` (exited ${formatTimestamp(stage.exitedAt)})`)
+        ? styleText('dim', ` (exited ${formatDateTime(stage.exitedAt)})`)
         : styleText('cyan', ' (current)');
 }
 function pendingEffectLines(instance) {
@@ -109,6 +110,6 @@ function historyLines(instance) {
     return [
         '',
         sectionHeader('History'),
-        ...instance.history.map((entry) => `  ${styleText('dim', `[${formatTimestamp(entry.at)}]`)} ${displayTitle(entry._type)}`),
+        ...instance.history.map((entry) => `  ${styleText('dim', `[${formatDateTime(entry.at)}]`)} ${displayTitle(entry._type)}`),
     ];
 }

package/dist/commands/workflows/tail.js

@@ -1,12 +1,12 @@
 import { styleText } from 'node:util';
 import { Args } from '@oclif/core';
+import { formatDateTime } from '@sanity/cli-core/dates';
 import { assertReadableModel, displayTitle, errorMessage, } from '@sanity/workflow-engine';
 import logSymbols from 'log-symbols';
 import { WorkflowCommand } from "../../lib/base-command.js";
 import { findInstance, resolveReadTargets } from "../../lib/context.js";
 import { fail, failureDetail } from "../../lib/fail.js";
 import { tagFlags } from "../../lib/flags.js";
-import { formatTimestamp } from "../../lib/ui.js";
 const TAIL_TAG = 'tail';
 export default class Tail extends WorkflowCommand {
     static description = 'Stream new history entries on a workflow instance as they land in the dataset.';
@@ -70,7 +70,7 @@ export default class Tail extends WorkflowCommand {
         const next = assertReadableModel(raw);
         const newEntries = next.history.slice(seen);
         for (const entry of newEntries) {
-            this.log(`${styleText('dim', `[${formatTimestamp(entry.at)}]`)} ${styleText('cyan', displayTitle(entry._type))}`);
+            this.log(`${styleText('dim', `[${formatDateTime(entry.at)}]`)} ${styleText('cyan', displayTitle(entry._type))}`);
         }
         return Math.max(seen, next.history.length);
     }

package/dist/lib/ui.d.ts

@@ -69,9 +69,3 @@ export declare function resourceLabel(resource: WorkflowResource): string;
 /** Status glyph per activity state. log-symbols ship pre-colored (green ✔, red ✖),
  *  so those need no extra wrap; the rest carry their own state color. */
 export declare const activityIcon: Record<ActivityStatus, string>;
-/** An engine ISO-8601 timestamp as an absolute `yyyy-MM-dd HH:mm:ss` — the
- *  Sanity CLI's audit-log format (see `backups/list`). For detail views. */
-export declare function formatTimestamp(iso: string): string;
-/** An engine ISO-8601 timestamp as a relative `… ago` — the Sanity CLI's
- *  job-list format (see `datasets/copy`). For scannable overview tables. */
-export declare function formatAge(iso: string): string;

package/dist/lib/ui.js

@@ -1,7 +1,4 @@
 import { stripVTControlCharacters, styleText } from 'node:util';
-import { formatDistanceToNow } from 'date-fns/formatDistanceToNow';
-import { lightFormat } from 'date-fns/lightFormat';
-import { parseISO } from 'date-fns/parseISO';
 import logSymbols from 'log-symbols';
 export function sectionHeader(title) {
     return styleText('bold', `${title}:`);
@@ -61,17 +58,3 @@ export const activityIcon = {
     failed: logSymbols.error,
     skipped: styleText('dim', '⊘'),
 };
-function parseTimestamp(iso) {
-    if (!iso)
-        return undefined;
-    const date = parseISO(iso);
-    return Number.isNaN(date.getTime()) ? undefined : date;
-}
-export function formatTimestamp(iso) {
-    const date = parseTimestamp(iso);
-    return date ? lightFormat(date, 'yyyy-MM-dd HH:mm:ss') : iso;
-}
-export function formatAge(iso) {
-    const date = parseTimestamp(iso);
-    return date ? `${formatDistanceToNow(date)} ago` : iso;
-}

package/oclif.manifest.json

@@ -289,6 +289,7 @@
         "<%= config.bin %> workflows list --include-completed",
         "<%= config.bin %> workflows list --definition productLaunch",
         "<%= config.bin %> workflows list --document dataset:proj:ds:article-1",
+        "<%= config.bin %> workflows list --assignment-user gAda --assignment-role legal --assignment-state routed",
         "<%= config.bin %> workflows list --tag prod",
         "<%= config.bin %> workflows list --json"
       ],
@@ -326,6 +327,32 @@
           "multiple": false,
           "type": "option"
         },
+        "assignment-user": {
+          "description": "Account-global user id used for viewer-scoped assignment filtering and counts.",
+          "name": "assignment-user",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "assignment-role": {
+          "description": "A literal project role held by --assignment-user. Repeat for multiple roles.",
+          "name": "assignment-role",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "assignment-state": {
+          "description": "Assignment state to include: unrouted, routed (offered through a supplied role), or held. Repeat for multiple states.",
+          "name": "assignment-state",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "options": [
+            "unrouted",
+            "routed",
+            "held"
+          ],
+          "type": "option"
+        },
         "limit": {
           "description": "Maximum rows to return.",
           "name": "limit",
@@ -948,5 +975,5 @@
       ]
     }
   },
-  "version": "0.30.0"
+  "version": "0.32.0"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sanity/workflow-cli",
-  "version": "0.30.0",
+  "version": "0.32.0",
   "description": "Command-line tool for deploying, inspecting, and administering Sanity workflow definitions and instances.",
   "keywords": [
     "cli",
@@ -47,27 +47,27 @@
   "dependencies": {
     "@oclif/core": "^4.11.4",
     "@oclif/plugin-help": "^6.2.50",
-    "@sanity/cli-core": "^2.1.1",
     "@sanity/client": "^7.22.1",
     "@sanity/telemetry": "^1.1.0",
     "boxen": "^8.0.1",
-    "date-fns": "^4.4.0",
     "diff": "^9.0.0",
     "jiti": "^2.7.0",
     "log-symbols": "^7.0.1",
     "ora": "^9.4.0"
   },
   "devDependencies": {
+    "@sanity/cli-core": "^3.6.0",
     "@types/diff": "^8.0.0",
     "@types/node": "^24.12.4",
     "oclif": "^4.23.16",
     "vitest": "^4.1.8",
-    "@sanity/workflow-engine": "0.30.0",
-    "@sanity/workflow-engine-test": "0.30.0",
-    "@sanity/workflow-examples": "0.11.0"
+    "@sanity/workflow-engine": "0.32.0",
+    "@sanity/workflow-engine-test": "0.32.0",
+    "@sanity/workflow-examples": "0.12.0"
   },
   "peerDependencies": {
-    "@sanity/workflow-engine": "0.30.0"
+    "@sanity/cli-core": "^3.6.0",
+    "@sanity/workflow-engine": "0.32.0"
   },
   "oclif": {
     "bin": "sanity-workflows",
@@ -98,6 +98,7 @@
   },
   "scripts": {
     "build": "rm -rf dist && tsc -p tsconfig.build.json && tsc -p tsconfig.declarations.json",
+    "docs": "node ../../scripts/run-typedoc.mjs",
     "typecheck": "tsc --noEmit -p tsconfig.json",
     "test": "vitest run",
     "test:packaging": "vitest run --config vitest.packaging.config.ts",