@shepai/cli 1.136.0-pr439.2a7af41 → 1.136.0-pr441.5eaafd1

package/dist/src/presentation/cli/commands/workflow/format-helpers.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Workflow CLI Format Helpers
+ *
+ * Shared formatting utilities for workflow CLI commands.
+ */
+import type { ScheduledWorkflow, WorkflowExecution } from '../../../../../packages/core/src/domain/generated/output.js';
+/**
+ * Format a workflow's current status indicator for list/show output.
+ */
+export declare function formatWorkflowStatus(workflow: ScheduledWorkflow): string;
+/**
+ * Format an execution status with color and symbol.
+ */
+export declare function formatExecutionStatus(status: string): string;
+/**
+ * Format a Date as a locale string.
+ */
+export declare function formatTimestamp(date: Date): string;
+/**
+ * Format a relative time string (e.g., "5 minutes ago").
+ */
+export declare function formatRelativeTime(date: Date): string;
+/**
+ * Format execution duration in human-readable form.
+ */
+export declare function formatDuration(ms: number): string;
+/**
+ * Format trigger type for display.
+ */
+export declare function formatTriggerType(triggerType: string): string;
+/**
+ * Format execution row for history table.
+ */
+export declare function formatExecutionRow(execution: WorkflowExecution): string[];
+//# sourceMappingURL=format-helpers.d.ts.map

package/dist/src/presentation/cli/commands/workflow/format-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-helpers.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/workflow/format-helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAGzF;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,CAQxE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAS5D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAElD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAWrD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAQjD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAI7D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,iBAAiB,GAAG,MAAM,EAAE,CAQzE"}

package/dist/src/presentation/cli/commands/workflow/format-helpers.js

@@ -0,0 +1,89 @@
+/**
+ * Workflow CLI Format Helpers
+ *
+ * Shared formatting utilities for workflow CLI commands.
+ */
+import { colors, symbols } from '../../ui/index.js';
+/**
+ * Format a workflow's current status indicator for list/show output.
+ */
+export function formatWorkflowStatus(workflow) {
+    if (!workflow.enabled) {
+        return `${colors.muted(symbols.dotEmpty)} ${colors.muted('disabled')}`;
+    }
+    if (workflow.cronExpression) {
+        return `${colors.success(symbols.dot)} ${colors.success('scheduled')}`;
+    }
+    return `${colors.info(symbols.dot)} ${colors.info('on-demand')}`;
+}
+/**
+ * Format an execution status with color and symbol.
+ */
+export function formatExecutionStatus(status) {
+    const map = {
+        queued: `${colors.muted(symbols.dotEmpty)} ${colors.muted('queued')}`,
+        running: `${colors.info(symbols.dot)} ${colors.info('running')}`,
+        completed: `${colors.success(symbols.success)} ${colors.success('completed')}`,
+        failed: `${colors.error(symbols.error)} ${colors.error('failed')}`,
+        cancelled: `${colors.muted(symbols.dotEmpty)} ${colors.muted('cancelled')}`,
+    };
+    return map[status] ?? colors.muted(status);
+}
+/**
+ * Format a Date as a locale string.
+ */
+export function formatTimestamp(date) {
+    return date.toLocaleString();
+}
+/**
+ * Format a relative time string (e.g., "5 minutes ago").
+ */
+export function formatRelativeTime(date) {
+    const diffMs = Date.now() - date.getTime();
+    const seconds = Math.floor(diffMs / 1000);
+    const minutes = Math.floor(seconds / 60);
+    const hours = Math.floor(minutes / 60);
+    const days = Math.floor(hours / 24);
+    if (days > 0)
+        return `${days}d ago`;
+    if (hours > 0)
+        return `${hours}h ago`;
+    if (minutes > 0)
+        return `${minutes}m ago`;
+    return `${seconds}s ago`;
+}
+/**
+ * Format execution duration in human-readable form.
+ */
+export function formatDuration(ms) {
+    const seconds = Math.floor(ms / 1000);
+    const minutes = Math.floor(seconds / 60);
+    const hours = Math.floor(minutes / 60);
+    if (hours > 0)
+        return `${hours}h ${minutes % 60}m`;
+    if (minutes > 0)
+        return `${minutes}m ${seconds % 60}s`;
+    return `${seconds}s`;
+}
+/**
+ * Format trigger type for display.
+ */
+export function formatTriggerType(triggerType) {
+    if (triggerType === 'manual')
+        return colors.info('manual');
+    if (triggerType === 'scheduled')
+        return colors.accent('scheduled');
+    return triggerType;
+}
+/**
+ * Format execution row for history table.
+ */
+export function formatExecutionRow(execution) {
+    return [
+        execution.id.substring(0, 8),
+        formatExecutionStatus(execution.status),
+        formatTriggerType(execution.triggerType),
+        execution.durationMs != null ? formatDuration(execution.durationMs) : colors.muted('-'),
+        formatTimestamp(new Date(execution.startedAt)),
+    ];
+}

package/dist/src/presentation/cli/commands/workflow/history.command.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Workflow History Command
+ *
+ * View execution history for a workflow.
+ *
+ * Usage:
+ *   shep workflow history <name>
+ *   shep workflow history <name> --limit 50
+ */
+import { Command } from 'commander';
+export declare function createHistoryCommand(): Command;
+//# sourceMappingURL=history.command.d.ts.map

package/dist/src/presentation/cli/commands/workflow/history.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.command.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/workflow/history.command.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,wBAAgB,oBAAoB,IAAI,OAAO,CAgC9C"}

package/dist/src/presentation/cli/commands/workflow/history.command.js

@@ -0,0 +1,46 @@
+/**
+ * Workflow History Command
+ *
+ * View execution history for a workflow.
+ *
+ * Usage:
+ *   shep workflow history <name>
+ *   shep workflow history <name> --limit 50
+ */
+import { Command } from 'commander';
+import { container } from '../../../../../packages/core/src/infrastructure/di/container.js';
+import { GetWorkflowHistoryUseCase } from '../../../../../packages/core/src/application/use-cases/workflows/get-workflow-history.use-case.js';
+import { messages, renderListView } from '../../ui/index.js';
+import { formatExecutionRow } from './format-helpers.js';
+export function createHistoryCommand() {
+    return new Command('history')
+        .description('View workflow execution history')
+        .argument('<name>', 'Workflow name or ID')
+        .option('-l, --limit <number>', 'Max results (default: 20)', parseInt)
+        .option('-r, --repo <path>', 'Repository path (defaults to current directory)')
+        .action(async (nameOrId, options) => {
+        try {
+            const repositoryPath = options.repo ?? process.cwd();
+            const useCase = container.resolve(GetWorkflowHistoryUseCase);
+            const executions = await useCase.execute(nameOrId, repositoryPath, options.limit);
+            const rows = executions.map(formatExecutionRow);
+            renderListView({
+                title: `Execution History: ${nameOrId}`,
+                columns: [
+                    { label: 'ID', width: 10 },
+                    { label: 'Status', width: 16 },
+                    { label: 'Trigger', width: 12 },
+                    { label: 'Duration', width: 10 },
+                    { label: 'Started', width: 22 },
+                ],
+                rows,
+                emptyMessage: 'No execution history found',
+            });
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            messages.error('Failed to get workflow history', err);
+            process.exitCode = 1;
+        }
+    });
+}

package/dist/src/presentation/cli/commands/workflow/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Workflow Command
+ *
+ * Top-level workflow command with subcommands for managing scheduled workflows.
+ *
+ * Usage:
+ *   shep workflow [subcommand]
+ *
+ * Subcommands:
+ *   shep workflow create <name>     Create a new workflow
+ *   shep workflow list               List all workflows
+ *   shep workflow show <name>       Show workflow details
+ *   shep workflow run <name>        Manually trigger a workflow
+ *   shep workflow schedule <name>   Set a cron schedule
+ *   shep workflow enable <name>     Enable a workflow's schedule
+ *   shep workflow disable <name>    Disable a workflow's schedule
+ *   shep workflow history <name>    View execution history
+ *   shep workflow update <name>     Update a workflow
+ *   shep workflow delete <name>     Delete a workflow
+ */
+import { Command } from 'commander';
+/**
+ * Create the workflow command with all subcommands.
+ */
+export declare function createWorkflowCommand(): Command;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/presentation/cli/commands/workflow/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/workflow/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYpC;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAa/C"}

package/dist/src/presentation/cli/commands/workflow/index.js

@@ -0,0 +1,48 @@
+/**
+ * Workflow Command
+ *
+ * Top-level workflow command with subcommands for managing scheduled workflows.
+ *
+ * Usage:
+ *   shep workflow [subcommand]
+ *
+ * Subcommands:
+ *   shep workflow create <name>     Create a new workflow
+ *   shep workflow list               List all workflows
+ *   shep workflow show <name>       Show workflow details
+ *   shep workflow run <name>        Manually trigger a workflow
+ *   shep workflow schedule <name>   Set a cron schedule
+ *   shep workflow enable <name>     Enable a workflow's schedule
+ *   shep workflow disable <name>    Disable a workflow's schedule
+ *   shep workflow history <name>    View execution history
+ *   shep workflow update <name>     Update a workflow
+ *   shep workflow delete <name>     Delete a workflow
+ */
+import { Command } from 'commander';
+import { createCreateCommand } from './create.command.js';
+import { createListCommand } from './list.command.js';
+import { createShowCommand } from './show.command.js';
+import { createRunCommand } from './run.command.js';
+import { createScheduleCommand } from './schedule.command.js';
+import { createEnableCommand } from './enable.command.js';
+import { createDisableCommand } from './disable.command.js';
+import { createHistoryCommand } from './history.command.js';
+import { createUpdateCommand } from './update.command.js';
+import { createDeleteCommand } from './delete.command.js';
+/**
+ * Create the workflow command with all subcommands.
+ */
+export function createWorkflowCommand() {
+    return new Command('workflow')
+        .description('Manage scheduled workflows')
+        .addCommand(createCreateCommand())
+        .addCommand(createListCommand())
+        .addCommand(createShowCommand())
+        .addCommand(createRunCommand())
+        .addCommand(createScheduleCommand())
+        .addCommand(createEnableCommand())
+        .addCommand(createDisableCommand())
+        .addCommand(createHistoryCommand())
+        .addCommand(createUpdateCommand())
+        .addCommand(createDeleteCommand());
+}

package/dist/src/presentation/cli/commands/workflow/list.command.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Workflow List Command
+ *
+ * List all workflows with their schedule, status, last run, and enabled state.
+ *
+ * Usage:
+ *   shep workflow list
+ */
+import { Command } from 'commander';
+export declare function createListCommand(): Command;
+//# sourceMappingURL=list.command.d.ts.map

package/dist/src/presentation/cli/commands/workflow/list.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.command.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/workflow/list.command.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,wBAAgB,iBAAiB,IAAI,OAAO,CAwC3C"}

package/dist/src/presentation/cli/commands/workflow/list.command.js

@@ -0,0 +1,52 @@
+/**
+ * Workflow List Command
+ *
+ * List all workflows with their schedule, status, last run, and enabled state.
+ *
+ * Usage:
+ *   shep workflow list
+ */
+import { Command } from 'commander';
+import { container } from '../../../../../packages/core/src/infrastructure/di/container.js';
+import { ListWorkflowsUseCase } from '../../../../../packages/core/src/application/use-cases/workflows/list-workflows.use-case.js';
+import { colors, symbols, messages, renderListView } from '../../ui/index.js';
+import { formatWorkflowStatus, formatRelativeTime } from './format-helpers.js';
+export function createListCommand() {
+    return new Command('list')
+        .alias('ls')
+        .description('List all workflows')
+        .option('-r, --repo <path>', 'Repository path (defaults to current directory)')
+        .action(async (options) => {
+        try {
+            const repositoryPath = options.repo ?? process.cwd();
+            const useCase = container.resolve(ListWorkflowsUseCase);
+            const workflows = await useCase.execute({ repositoryPath });
+            const rows = workflows.map((w) => [
+                w.name,
+                w.cronExpression ?? colors.muted('-'),
+                formatWorkflowStatus(w),
+                w.lastRunAt ? formatRelativeTime(new Date(w.lastRunAt)) : colors.muted('never'),
+                w.enabled
+                    ? `${colors.success(symbols.dot)} ${colors.success('on')}`
+                    : `${colors.muted(symbols.dotEmpty)} ${colors.muted('off')}`,
+            ]);
+            renderListView({
+                title: 'Workflows',
+                columns: [
+                    { label: 'Name', width: 22 },
+                    { label: 'Schedule', width: 20 },
+                    { label: 'Status', width: 16 },
+                    { label: 'Last Run', width: 14 },
+                    { label: 'Enabled', width: 10 },
+                ],
+                rows,
+                emptyMessage: 'No workflows found. Create one with: shep workflow create <name> --prompt <prompt>',
+            });
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            messages.error('Failed to list workflows', err);
+            process.exitCode = 1;
+        }
+    });
+}

package/dist/src/presentation/cli/commands/workflow/run.command.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Workflow Run Command
+ *
+ * Manually trigger a workflow execution.
+ *
+ * Usage:
+ *   shep workflow run <name>
+ */
+import { Command } from 'commander';
+export declare function createRunCommand(): Command;
+//# sourceMappingURL=run.command.d.ts.map

package/dist/src/presentation/cli/commands/workflow/run.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.command.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/workflow/run.command.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,wBAAgB,gBAAgB,IAAI,OAAO,CA0B1C"}

package/dist/src/presentation/cli/commands/workflow/run.command.js

@@ -0,0 +1,37 @@
+/**
+ * Workflow Run Command
+ *
+ * Manually trigger a workflow execution.
+ *
+ * Usage:
+ *   shep workflow run <name>
+ */
+import { Command } from 'commander';
+import { container } from '../../../../../packages/core/src/infrastructure/di/container.js';
+import { RunWorkflowUseCase } from '../../../../../packages/core/src/application/use-cases/workflows/run-workflow.use-case.js';
+import { colors, messages } from '../../ui/index.js';
+export function createRunCommand() {
+    return new Command('run')
+        .description('Manually trigger a workflow')
+        .argument('<name>', 'Workflow name or ID')
+        .option('-r, --repo <path>', 'Repository path (defaults to current directory)')
+        .action(async (nameOrId, options) => {
+        try {
+            const repositoryPath = options.repo ?? process.cwd();
+            const useCase = container.resolve(RunWorkflowUseCase);
+            const execution = await useCase.execute(nameOrId, repositoryPath);
+            messages.newline();
+            messages.success('Workflow execution queued');
+            console.log(`  ${colors.muted('Execution ID:')} ${execution.id.substring(0, 8)}`);
+            console.log(`  ${colors.muted('Status:')}       ${colors.info('queued')}`);
+            console.log(`  ${colors.muted('Trigger:')}      ${colors.info('manual')}`);
+            messages.newline();
+            messages.info(`View execution history: ${colors.accent(`shep workflow history ${nameOrId}`)}`);
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            messages.error('Failed to run workflow', err);
+            process.exitCode = 1;
+        }
+    });
+}

package/dist/src/presentation/cli/commands/workflow/schedule.command.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Workflow Schedule Command
+ *
+ * Set, update, or remove a cron schedule on a workflow.
+ *
+ * Usage:
+ *   shep workflow schedule <name> --cron "0 9 * * MON"
+ *   shep workflow schedule <name> --cron "0 9 * * MON" --timezone "America/New_York"
+ *   shep workflow schedule <name> --remove
+ */
+import { Command } from 'commander';
+export declare function createScheduleCommand(): Command;
+//# sourceMappingURL=schedule.command.d.ts.map

package/dist/src/presentation/cli/commands/workflow/schedule.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule.command.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/workflow/schedule.command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,wBAAgB,qBAAqB,IAAI,OAAO,CAmF/C"}

package/dist/src/presentation/cli/commands/workflow/schedule.command.js

@@ -0,0 +1,76 @@
+/**
+ * Workflow Schedule Command
+ *
+ * Set, update, or remove a cron schedule on a workflow.
+ *
+ * Usage:
+ *   shep workflow schedule <name> --cron "0 9 * * MON"
+ *   shep workflow schedule <name> --cron "0 9 * * MON" --timezone "America/New_York"
+ *   shep workflow schedule <name> --remove
+ */
+import { Command } from 'commander';
+import { container } from '../../../../../packages/core/src/infrastructure/di/container.js';
+import { ScheduleWorkflowUseCase } from '../../../../../packages/core/src/application/use-cases/workflows/schedule-workflow.use-case.js';
+import { colors, messages } from '../../ui/index.js';
+import { formatTimestamp } from './format-helpers.js';
+export function createScheduleCommand() {
+    return new Command('schedule')
+        .description('Set a cron schedule on a workflow')
+        .argument('<name>', 'Workflow name or ID')
+        .option('-c, --cron <expression>', 'Cron expression (e.g., "0 9 * * MON" for every Monday at 9am)')
+        .option('-z, --timezone <tz>', 'IANA timezone (e.g., "America/New_York")')
+        .option('--remove', 'Remove the current schedule')
+        .option('-r, --repo <path>', 'Repository path (defaults to current directory)')
+        .addHelpText('after', `
+Examples:
+  shep workflow schedule my-workflow --cron "0 9 * * MON"           Every Monday at 9am
+  shep workflow schedule my-workflow --cron "0 */6 * * *"           Every 6 hours
+  shep workflow schedule my-workflow --cron "30 2 * * *" -z UTC     Daily at 2:30 AM UTC
+  shep workflow schedule my-workflow --remove                        Remove schedule
+
+Cron format: minute hour day-of-month month day-of-week
+  minute:        0-59
+  hour:          0-23
+  day-of-month:  1-31
+  month:         1-12 (or JAN-DEC)
+  day-of-week:   0-7 (0 and 7 are Sunday, or MON-SUN)
+`)
+        .action(async (nameOrId, options) => {
+        try {
+            if (!options.cron && !options.remove) {
+                messages.error('Specify a cron expression with --cron or --remove to clear the schedule.\n' +
+                    'Example: shep workflow schedule my-workflow --cron "0 9 * * MON"');
+                process.exitCode = 1;
+                return;
+            }
+            const repositoryPath = options.repo ?? process.cwd();
+            const useCase = container.resolve(ScheduleWorkflowUseCase);
+            const workflow = await useCase.execute({
+                nameOrId,
+                repositoryPath,
+                cronExpression: options.remove ? null : (options.cron ?? null),
+                ...(options.timezone != null && { timezone: options.timezone }),
+            });
+            messages.newline();
+            if (options.remove) {
+                messages.success(`Schedule removed from "${workflow.name}"`);
+            }
+            else {
+                messages.success(`Schedule set for "${workflow.name}"`);
+                console.log(`  ${colors.muted('Cron:')}     ${colors.accent(workflow.cronExpression ?? '-')}`);
+                if (workflow.timezone) {
+                    console.log(`  ${colors.muted('Timezone:')} ${workflow.timezone}`);
+                }
+                if (workflow.nextRunAt) {
+                    console.log(`  ${colors.muted('Next run:')} ${formatTimestamp(new Date(workflow.nextRunAt))}`);
+                }
+            }
+            messages.newline();
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            messages.error('Failed to set schedule', err);
+            process.exitCode = 1;
+        }
+    });
+}

package/dist/src/presentation/cli/commands/workflow/show.command.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Workflow Show Command
+ *
+ * Display detailed information about a specific workflow.
+ *
+ * Usage:
+ *   shep workflow show <name>
+ */
+import { Command } from 'commander';
+export declare function createShowCommand(): Command;
+//# sourceMappingURL=show.command.d.ts.map

package/dist/src/presentation/cli/commands/workflow/show.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"show.command.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/workflow/show.command.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,wBAAgB,iBAAiB,IAAI,OAAO,CAgF3C"}

package/dist/src/presentation/cli/commands/workflow/show.command.js

@@ -0,0 +1,93 @@
+/**
+ * Workflow Show Command
+ *
+ * Display detailed information about a specific workflow.
+ *
+ * Usage:
+ *   shep workflow show <name>
+ */
+import { Command } from 'commander';
+import { container } from '../../../../../packages/core/src/infrastructure/di/container.js';
+import { GetWorkflowUseCase } from '../../../../../packages/core/src/application/use-cases/workflows/get-workflow.use-case.js';
+import { colors, messages, renderDetailView } from '../../ui/index.js';
+import { formatWorkflowStatus, formatTimestamp, formatRelativeTime } from './format-helpers.js';
+export function createShowCommand() {
+    return new Command('show')
+        .description('Show workflow details')
+        .argument('<name>', 'Workflow name or ID')
+        .option('-r, --repo <path>', 'Repository path (defaults to current directory)')
+        .action(async (nameOrId, options) => {
+        try {
+            const repositoryPath = options.repo ?? process.cwd();
+            const useCase = container.resolve(GetWorkflowUseCase);
+            const workflow = await useCase.execute(nameOrId, repositoryPath);
+            renderDetailView({
+                title: `Workflow: ${workflow.name}`,
+                sections: [
+                    {
+                        fields: [
+                            { label: 'ID', value: workflow.id },
+                            { label: 'Name', value: colors.accent(workflow.name) },
+                            { label: 'Description', value: workflow.description ?? null },
+                            { label: 'Status', value: formatWorkflowStatus(workflow) },
+                            {
+                                label: 'Enabled',
+                                value: workflow.enabled ? colors.success('yes') : colors.muted('no'),
+                            },
+                            { label: 'Repository', value: workflow.repositoryPath },
+                        ],
+                    },
+                    {
+                        title: 'Schedule',
+                        fields: [
+                            { label: 'Cron', value: workflow.cronExpression ?? colors.muted('none') },
+                            { label: 'Timezone', value: workflow.timezone ?? colors.muted('system default') },
+                            {
+                                label: 'Next Run',
+                                value: workflow.nextRunAt
+                                    ? formatTimestamp(new Date(workflow.nextRunAt))
+                                    : colors.muted('none'),
+                            },
+                            {
+                                label: 'Last Run',
+                                value: workflow.lastRunAt
+                                    ? `${formatTimestamp(new Date(workflow.lastRunAt))} (${formatRelativeTime(new Date(workflow.lastRunAt))})`
+                                    : colors.muted('never'),
+                            },
+                        ],
+                    },
+                    {
+                        title: 'Constraints',
+                        fields: [
+                            {
+                                label: 'Tools',
+                                value: workflow.toolConstraints && workflow.toolConstraints.length > 0
+                                    ? workflow.toolConstraints.join(', ')
+                                    : colors.muted('all tools allowed'),
+                            },
+                        ],
+                    },
+                    {
+                        title: 'Timestamps',
+                        fields: [
+                            { label: 'Created', value: formatTimestamp(new Date(workflow.createdAt)) },
+                            { label: 'Updated', value: formatTimestamp(new Date(workflow.updatedAt)) },
+                        ],
+                    },
+                ],
+                textBlocks: [
+                    {
+                        title: 'Prompt',
+                        content: workflow.prompt,
+                        color: colors.muted,
+                    },
+                ],
+            });
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            messages.error('Failed to show workflow', err);
+            process.exitCode = 1;
+        }
+    });
+}

package/dist/src/presentation/cli/commands/workflow/update.command.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Workflow Update Command
+ *
+ * Update an existing workflow's fields (partial update).
+ *
+ * Usage:
+ *   shep workflow update <name> --description "New description"
+ *   shep workflow update <name> --prompt "New prompt"
+ *   shep workflow update <name> --name "new-name"
+ */
+import { Command } from 'commander';
+export declare function createUpdateCommand(): Command;
+//# sourceMappingURL=update.command.d.ts.map

package/dist/src/presentation/cli/commands/workflow/update.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.command.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/workflow/update.command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC,wBAAgB,mBAAmB,IAAI,OAAO,CAwE7C"}