hzl-cli 2.0.0 → 2.2.0

package/dist/commands/workflow/list.js

@@ -0,0 +1,41 @@
+import { Command } from 'commander';
+import { WorkflowService } from 'hzl-core/services/workflow-service.js';
+import { resolveDbPaths } from '../../config.js';
+import { closeDb, initializeDb } from '../../db.js';
+import { handleError } from '../../errors.js';
+import { GlobalOptionsSchema } from '../../types.js';
+function createWorkflowService(services) {
+    return new WorkflowService(services.cacheDb, services.eventStore, services.projectionEngine, services.taskService, services.db);
+}
+export function runWorkflowList(options) {
+    const workflowService = createWorkflowService(options.services);
+    const result = { workflows: workflowService.listWorkflows() };
+    if (options.json) {
+        console.log(JSON.stringify(result));
+    }
+    else {
+        for (const workflow of result.workflows) {
+            console.log(`${workflow.name}: ${workflow.description}`);
+        }
+    }
+    return result;
+}
+export function createWorkflowListCommand() {
+    return new Command('list')
+        .description('List available built-in workflows')
+        .action(function () {
+        const globalOpts = GlobalOptionsSchema.parse(this.optsWithGlobals());
+        const { eventsDbPath, cacheDbPath } = resolveDbPaths(globalOpts.db);
+        const services = initializeDb({ eventsDbPath, cacheDbPath });
+        try {
+            runWorkflowList({ services, json: globalOpts.json ?? false });
+        }
+        catch (error) {
+            handleError(error, globalOpts.json);
+        }
+        finally {
+            closeDb(services);
+        }
+    });
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/workflow/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/commands/workflow/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,YAAY,EAAiB,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AASrD,SAAS,qBAAqB,CAAC,QAAkB;IAC/C,OAAO,IAAI,eAAe,CACxB,QAAQ,CAAC,OAAO,EAChB,QAAQ,CAAC,UAAU,EACnB,QAAQ,CAAC,gBAAgB,EACzB,QAAQ,CAAC,WAAW,EACpB,QAAQ,CAAC,EAAE,CACZ,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAG/B;IACC,MAAM,eAAe,GAAG,qBAAqB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAChE,MAAM,MAAM,GAAuB,EAAE,SAAS,EAAE,eAAe,CAAC,aAAa,EAAE,EAAE,CAAC;IAElF,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;IACtC,CAAC;SAAM,CAAC;QACN,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YACxC,OAAO,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,yBAAyB;IACvC,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;SACvB,WAAW,CAAC,mCAAmC,CAAC;SAChD,MAAM,CAAC;QACN,MAAM,UAAU,GAAG,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC;QACrE,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,GAAG,cAAc,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QACpE,MAAM,QAAQ,GAAG,YAAY,CAAC,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC,CAAC;QAC7D,IAAI,CAAC;YACH,eAAe,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC;QAChE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,WAAW,CAAC,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;QACtC,CAAC;gBAAS,CAAC;YACT,OAAO,CAAC,QAAQ,CAAC,CAAC;QACpB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/workflow/run.d.ts

@@ -0,0 +1,45 @@
+import { Command } from 'commander';
+import { type OthersLimit, type WorkflowDelegateResult, type WorkflowHandoffResult, type WorkflowStartResult } from 'hzl-core/services/workflow-service.js';
+import { type Services } from '../../db.js';
+export declare function runWorkflowStart(options: {
+    services: Services;
+    agent: string;
+    project?: string;
+    tags?: string[];
+    leaseMinutes?: number;
+    resumePolicy?: 'first' | 'latest' | 'priority';
+    includeOthers?: boolean;
+    othersLimit?: OthersLimit;
+    opId?: string;
+    autoOpId?: boolean;
+    json: boolean;
+}): WorkflowStartResult;
+export declare function runWorkflowHandoff(options: {
+    services: Services;
+    fromTaskId: string;
+    title: string;
+    project?: string;
+    agent?: string;
+    carryCheckpoints?: number;
+    carryMaxChars?: number;
+    author?: string;
+    opId?: string;
+    autoOpId?: boolean;
+    json: boolean;
+}): WorkflowHandoffResult;
+export declare function runWorkflowDelegate(options: {
+    services: Services;
+    fromTaskId: string;
+    title: string;
+    project?: string;
+    agent?: string;
+    dependsOnParent?: boolean;
+    checkpoint?: string;
+    pauseParent?: boolean;
+    author?: string;
+    opId?: string;
+    autoOpId?: boolean;
+    json: boolean;
+}): WorkflowDelegateResult;
+export declare function createWorkflowRunCommand(): Command;
+//# sourceMappingURL=run.d.ts.map

package/dist/commands/workflow/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/commands/workflow/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACzB,MAAM,uCAAuC,CAAC;AAE/C,OAAO,EAAyB,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AA8EnE,wBAAgB,gBAAgB,CAAC,OAAO,EAAE;IACxC,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC;IAC/C,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,OAAO,CAAC;CACf,GAAG,mBAAmB,CA+BtB;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IAC1C,QAAQ,EAAE,QAAQ,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,OAAO,CAAC;CACf,GAAG,qBAAqB,CAqBxB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAC3C,QAAQ,EAAE,QAAQ,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,OAAO,CAAC;CACf,GAAG,sBAAsB,CAsBzB;AAED,wBAAgB,wBAAwB,IAAI,OAAO,CAoIlD"}

package/dist/commands/workflow/run.js

@@ -0,0 +1,243 @@
+import { Command } from 'commander';
+import { WorkflowService, } from 'hzl-core/services/workflow-service.js';
+import { resolveDbPaths } from '../../config.js';
+import { closeDb, initializeDb } from '../../db.js';
+import { CLIError, ExitCode, handleError } from '../../errors.js';
+import { resolveId } from '../../resolve-id.js';
+import { GlobalOptionsSchema } from '../../types.js';
+import { parseInteger, parseOptionalInteger } from '../../parse.js';
+function createWorkflowService(services) {
+    return new WorkflowService(services.cacheDb, services.eventStore, services.projectionEngine, services.taskService, services.db);
+}
+function parseTags(raw) {
+    const tags = raw?.split(',').map((tag) => tag.trim()).filter(Boolean);
+    return tags && tags.length > 0 ? tags : undefined;
+}
+function parsePositiveInt(raw, optionName) {
+    return parseOptionalInteger(raw, optionName, { min: 0 });
+}
+function parseOthersLimit(raw) {
+    if (raw === undefined)
+        return undefined;
+    if (raw === 'all')
+        return 'all';
+    try {
+        return parseInteger(raw, '--others-limit', { min: 0 });
+    }
+    catch {
+        throw new CLIError('--others-limit must be a non-negative integer or "all"', ExitCode.InvalidInput);
+    }
+}
+function assertNoConflictingOpFlags(opts) {
+    if (opts.opId && opts.autoOpId) {
+        throw new CLIError('Cannot use --op-id and --auto-op-id together.', ExitCode.InvalidInput);
+    }
+}
+export function runWorkflowStart(options) {
+    if (options.autoOpId) {
+        throw new CLIError('--auto-op-id is not supported for workflow run start; use --op-id for intentional retries.', ExitCode.InvalidInput);
+    }
+    const workflowService = createWorkflowService(options.services);
+    const result = workflowService.runStart({
+        agent: options.agent,
+        project: options.project,
+        tags: options.tags,
+        lease_minutes: options.leaseMinutes,
+        resume_policy: options.resumePolicy,
+        include_others: options.includeOthers,
+        others_limit: options.othersLimit,
+        op_id: options.opId,
+    });
+    if (options.json) {
+        console.log(JSON.stringify(result));
+    }
+    else if (!result.selected) {
+        console.log('No eligible task to start.');
+    }
+    else if (result.mode === 'resume') {
+        console.log(`✓ Resumed task ${result.selected.task_id}: ${result.selected.title}`);
+    }
+    else {
+        console.log(`✓ Claimed task ${result.selected.task_id}: ${result.selected.title}`);
+    }
+    return result;
+}
+export function runWorkflowHandoff(options) {
+    const workflowService = createWorkflowService(options.services);
+    const result = workflowService.runHandoff({
+        from_task_id: options.fromTaskId,
+        title: options.title,
+        project: options.project,
+        agent: options.agent,
+        carry_checkpoints: options.carryCheckpoints,
+        carry_max_chars: options.carryMaxChars,
+        author: options.author,
+        op_id: options.opId,
+        auto_op_id: options.autoOpId,
+    });
+    if (options.json) {
+        console.log(JSON.stringify(result));
+    }
+    else {
+        console.log(`✓ Handed off ${result.source_task_id} -> ${result.follow_on.task_id}`);
+    }
+    return result;
+}
+export function runWorkflowDelegate(options) {
+    const workflowService = createWorkflowService(options.services);
+    const result = workflowService.runDelegate({
+        from_task_id: options.fromTaskId,
+        title: options.title,
+        project: options.project,
+        agent: options.agent,
+        depends_on_parent: options.dependsOnParent,
+        checkpoint: options.checkpoint,
+        pause_parent: options.pauseParent,
+        author: options.author,
+        op_id: options.opId,
+        auto_op_id: options.autoOpId,
+    });
+    if (options.json) {
+        console.log(JSON.stringify(result));
+    }
+    else {
+        console.log(`✓ Delegated ${result.source_task_id} -> ${result.delegated.task_id}`);
+    }
+    return result;
+}
+export function createWorkflowRunCommand() {
+    const command = new Command('run').description('Run a built-in workflow');
+    command
+        .command('start')
+        .description('Resume in-progress work for an agent, otherwise claim next')
+        .requiredOption('--agent <name>', 'Agent identity for resume/claim')
+        .option('-P, --project <project>', 'Project filter for resume/claim')
+        .option('--tags <tags>', 'Required tags, comma-separated')
+        .option('-l, --lease <minutes>', 'Lease duration in minutes')
+        .option('--resume-policy <policy>', 'Resume policy: first | latest | priority', 'priority')
+        .option('--include-others', 'Include alternate candidates in response')
+        .option('--no-include-others', 'Exclude alternate candidates from response')
+        .option('--others-limit <n|all>', 'Bound alternate candidates in response', '5')
+        .option('--op-id <key>', 'Explicit idempotency key')
+        .option('--auto-op-id', 'Unsupported for start; use explicit --op-id retries instead')
+        .action(function (opts) {
+        const globalOpts = GlobalOptionsSchema.parse(this.optsWithGlobals());
+        const { eventsDbPath, cacheDbPath } = resolveDbPaths(globalOpts.db);
+        const services = initializeDb({ eventsDbPath, cacheDbPath });
+        try {
+            assertNoConflictingOpFlags(opts);
+            if (!opts.agent) {
+                throw new CLIError('--agent is required', ExitCode.InvalidUsage);
+            }
+            runWorkflowStart({
+                services,
+                agent: opts.agent,
+                project: opts.project,
+                tags: parseTags(opts.tags),
+                leaseMinutes: parsePositiveInt(opts.lease, '--lease'),
+                resumePolicy: opts.resumePolicy ?? 'priority',
+                includeOthers: opts.includeOthers,
+                othersLimit: parseOthersLimit(opts.othersLimit),
+                opId: opts.opId,
+                autoOpId: opts.autoOpId,
+                json: globalOpts.json ?? false,
+            });
+        }
+        catch (error) {
+            handleError(error, globalOpts.json);
+        }
+        finally {
+            closeDb(services);
+        }
+    });
+    command
+        .command('handoff')
+        .description('Complete source task and create a follow-on task')
+        .requiredOption('--from <taskId>', 'Source task id')
+        .requiredOption('--title <title>', 'Follow-on task title')
+        .option('-P, --project <project>', 'Follow-on task project')
+        .option('--agent <agent>', 'Follow-on task assignee')
+        .option('--carry-checkpoints <n>', 'Number of checkpoints to carry', '3')
+        .option('--carry-max-chars <n>', 'Max carried checkpoint chars', '4000')
+        .option('--author <name>', 'Author for emitted workflow events')
+        .option('--op-id <key>', 'Explicit idempotency key')
+        .option('--auto-op-id', 'Generate deterministic idempotency key from normalized input')
+        .action(function (opts) {
+        const globalOpts = GlobalOptionsSchema.parse(this.optsWithGlobals());
+        const { eventsDbPath, cacheDbPath } = resolveDbPaths(globalOpts.db);
+        const services = initializeDb({ eventsDbPath, cacheDbPath });
+        try {
+            assertNoConflictingOpFlags(opts);
+            if (!opts.from || !opts.title) {
+                throw new CLIError('--from and --title are required', ExitCode.InvalidUsage);
+            }
+            const fromTaskId = resolveId(services, opts.from);
+            runWorkflowHandoff({
+                services,
+                fromTaskId,
+                title: opts.title,
+                project: opts.project,
+                agent: opts.agent,
+                carryCheckpoints: parsePositiveInt(opts.carryCheckpoints, '--carry-checkpoints'),
+                carryMaxChars: parsePositiveInt(opts.carryMaxChars, '--carry-max-chars'),
+                author: opts.author,
+                opId: opts.opId,
+                autoOpId: opts.autoOpId,
+                json: globalOpts.json ?? false,
+            });
+        }
+        catch (error) {
+            handleError(error, globalOpts.json);
+        }
+        finally {
+            closeDb(services);
+        }
+    });
+    command
+        .command('delegate')
+        .description('Create delegated task, add dependency by default, optionally pause parent')
+        .requiredOption('--from <taskId>', 'Source task id')
+        .requiredOption('--title <title>', 'Delegated task title')
+        .option('-P, --project <project>', 'Delegated task project')
+        .option('--agent <agent>', 'Delegated task assignee')
+        .option('--no-depends', 'Do not add parent->delegated dependency edge')
+        .option('--checkpoint <text>', 'Checkpoint to add to source task')
+        .option('--pause-parent', 'Pause parent task (blocked) when currently in_progress')
+        .option('--author <name>', 'Author for emitted workflow events')
+        .option('--op-id <key>', 'Explicit idempotency key')
+        .option('--auto-op-id', 'Generate deterministic idempotency key from normalized input')
+        .action(function (opts) {
+        const globalOpts = GlobalOptionsSchema.parse(this.optsWithGlobals());
+        const { eventsDbPath, cacheDbPath } = resolveDbPaths(globalOpts.db);
+        const services = initializeDb({ eventsDbPath, cacheDbPath });
+        try {
+            assertNoConflictingOpFlags(opts);
+            if (!opts.from || !opts.title) {
+                throw new CLIError('--from and --title are required', ExitCode.InvalidUsage);
+            }
+            const fromTaskId = resolveId(services, opts.from);
+            runWorkflowDelegate({
+                services,
+                fromTaskId,
+                title: opts.title,
+                project: opts.project,
+                agent: opts.agent,
+                dependsOnParent: opts.depends,
+                checkpoint: opts.checkpoint,
+                pauseParent: opts.pauseParent,
+                author: opts.author,
+                opId: opts.opId,
+                autoOpId: opts.autoOpId,
+                json: globalOpts.json ?? false,
+            });
+        }
+        catch (error) {
+            handleError(error, globalOpts.json);
+        }
+        finally {
+            closeDb(services);
+        }
+    });
+    return command;
+}
+//# sourceMappingURL=run.js.map

package/dist/commands/workflow/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../../src/commands/workflow/run.ts"],"names":[],"mappings":"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"}

package/dist/commands/workflow/run.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=run.test.d.ts.map

package/dist/commands/workflow/run.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.test.d.ts","sourceRoot":"","sources":["../../../src/commands/workflow/run.test.ts"],"names":[],"mappings":""}

package/dist/commands/workflow/run.test.js

@@ -0,0 +1,100 @@
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { runWorkflowDelegate, runWorkflowHandoff, runWorkflowStart, } from './run.js';
+import { closeDb, initializeDbFromPath } from '../../db.js';
+import { TaskStatus } from 'hzl-core/events/types.js';
+describe('workflow run commands', () => {
+    let tempDir;
+    let dbPath;
+    let services;
+    beforeEach(() => {
+        tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'hzl-workflow-run-test-'));
+        dbPath = path.join(tempDir, 'test.db');
+        services = initializeDbFromPath(dbPath);
+    });
+    afterEach(() => {
+        closeDb(services);
+        fs.rmSync(tempDir, { recursive: true, force: true });
+    });
+    it('start resumes in_progress task before claiming next', () => {
+        const resumed = services.taskService.createTask({
+            title: 'Resume',
+            project: 'inbox',
+            initial_status: TaskStatus.InProgress,
+            agent: 'agent-1',
+        });
+        const ready = services.taskService.createTask({ title: 'Ready', project: 'inbox' });
+        services.taskService.setStatus(ready.task_id, TaskStatus.Ready);
+        const result = runWorkflowStart({
+            services,
+            agent: 'agent-1',
+            json: false,
+        });
+        expect(result.mode).toBe('resume');
+        expect(result.selected?.task_id).toBe(resumed.task_id);
+        expect(services.taskService.getTaskById(ready.task_id)?.status).toBe(TaskStatus.Ready);
+    });
+    it('handoff applies guardrail requiring agent or project', () => {
+        const source = services.taskService.createTask({ title: 'Source', project: 'inbox' });
+        services.taskService.setStatus(source.task_id, TaskStatus.Ready);
+        services.taskService.claimTask(source.task_id, { author: 'agent-1' });
+        expect(() => runWorkflowHandoff({
+            services,
+            fromTaskId: source.task_id,
+            title: 'Follow on',
+            json: false,
+        })).toThrow(/requires --agent, --project, or both/i);
+    });
+    it('delegate adds parent dependency by default', () => {
+        const source = services.taskService.createTask({ title: 'Source', project: 'inbox' });
+        services.taskService.setStatus(source.task_id, TaskStatus.Ready);
+        services.taskService.claimTask(source.task_id, { author: 'agent-1' });
+        const result = runWorkflowDelegate({
+            services,
+            fromTaskId: source.task_id,
+            title: 'Delegated',
+            json: false,
+        });
+        const row = services.cacheDb
+            .prepare('SELECT depends_on_id FROM task_dependencies WHERE task_id = ?')
+            .get(source.task_id);
+        expect(row?.depends_on_id).toBe(result.delegated.task_id);
+    });
+    it('replays cached result when op_id table exists and op_id is reused', () => {
+        services.db.exec(`
+      CREATE TABLE op_id (
+        op_id TEXT PRIMARY KEY,
+        scope TEXT,
+        input_hash TEXT,
+        result TEXT,
+        state TEXT,
+        created_at TEXT,
+        updated_at TEXT
+      );
+    `);
+        const source = services.taskService.createTask({ title: 'Source', project: 'inbox' });
+        services.taskService.setStatus(source.task_id, TaskStatus.Ready);
+        services.taskService.claimTask(source.task_id, { author: 'agent-1' });
+        const first = runWorkflowHandoff({
+            services,
+            fromTaskId: source.task_id,
+            title: 'Follow on',
+            project: 'inbox',
+            opId: 'handoff-1',
+            json: false,
+        });
+        const second = runWorkflowHandoff({
+            services,
+            fromTaskId: source.task_id,
+            title: 'Follow on',
+            project: 'inbox',
+            opId: 'handoff-1',
+            json: false,
+        });
+        expect(first.follow_on.task_id).toBe(second.follow_on.task_id);
+        expect(second.idempotency.replayed).toBe(true);
+    });
+});
+//# sourceMappingURL=run.test.js.map

package/dist/commands/workflow/run.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.test.js","sourceRoot":"","sources":["../../../src/commands/workflow/run.test.ts"],"names":[],"mappings":"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"}

package/dist/commands/workflow/show.d.ts

@@ -0,0 +1,24 @@
+import { Command } from 'commander';
+import { type WorkflowName } from 'hzl-core/services/workflow-service.js';
+import { type Services } from '../../db.js';
+export interface WorkflowShowResult {
+    workflow: {
+        name: WorkflowName;
+        description: string;
+        supports_auto_op_id: boolean;
+        args: Array<{
+            name: string;
+            required: boolean;
+            description: string;
+            default?: string;
+        }>;
+        notes: string[];
+    };
+}
+export declare function runWorkflowShow(options: {
+    services: Services;
+    name: string;
+    json: boolean;
+}): WorkflowShowResult;
+export declare function createWorkflowShowCommand(): Command;
+//# sourceMappingURL=show.d.ts.map

package/dist/commands/workflow/show.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"show.d.ts","sourceRoot":"","sources":["../../../src/commands/workflow/show.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAEL,KAAK,YAAY,EAClB,MAAM,uCAAuC,CAAC;AAE/C,OAAO,EAAyB,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAInE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE;QACR,IAAI,EAAE,YAAY,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,mBAAmB,EAAE,OAAO,CAAC;QAC7B,IAAI,EAAE,KAAK,CAAC;YACV,IAAI,EAAE,MAAM,CAAC;YACb,QAAQ,EAAE,OAAO,CAAC;YAClB,WAAW,EAAE,MAAM,CAAC;YACpB,OAAO,CAAC,EAAE,MAAM,CAAC;SAClB,CAAC,CAAC;QACH,KAAK,EAAE,MAAM,EAAE,CAAC;KACjB,CAAC;CACH;AAmBD,wBAAgB,eAAe,CAAC,OAAO,EAAE;IACvC,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;CACf,GAAG,kBAAkB,CA2BrB;AAED,wBAAgB,yBAAyB,IAAI,OAAO,CAgBnD"}

package/dist/commands/workflow/show.js

@@ -0,0 +1,62 @@
+import { Command } from 'commander';
+import { WorkflowService, } from 'hzl-core/services/workflow-service.js';
+import { resolveDbPaths } from '../../config.js';
+import { closeDb, initializeDb } from '../../db.js';
+import { CLIError, ExitCode, handleError } from '../../errors.js';
+import { GlobalOptionsSchema } from '../../types.js';
+function createWorkflowService(services) {
+    return new WorkflowService(services.cacheDb, services.eventStore, services.projectionEngine, services.taskService, services.db);
+}
+function parseWorkflowName(name) {
+    if (name === 'start' || name === 'handoff' || name === 'delegate') {
+        return name;
+    }
+    throw new CLIError(`Unknown workflow: ${name}`, ExitCode.NotFound);
+}
+export function runWorkflowShow(options) {
+    const workflowName = parseWorkflowName(options.name);
+    const workflowService = createWorkflowService(options.services);
+    const definition = workflowService.showWorkflow(workflowName);
+    const result = { workflow: definition };
+    if (options.json) {
+        console.log(JSON.stringify(result));
+    }
+    else {
+        console.log(`${definition.name}`);
+        console.log(`Description: ${definition.description}`);
+        console.log(`Supports --auto-op-id: ${definition.supports_auto_op_id ? 'yes' : 'no'}`);
+        console.log('Arguments:');
+        for (const arg of definition.args) {
+            const required = arg.required ? 'required' : 'optional';
+            const defaultText = arg.default ? ` [default: ${arg.default}]` : '';
+            console.log(`  ${arg.name} (${required}) - ${arg.description}${defaultText}`);
+        }
+        if (definition.notes.length > 0) {
+            console.log('Notes:');
+            for (const note of definition.notes) {
+                console.log(`  - ${note}`);
+            }
+        }
+    }
+    return result;
+}
+export function createWorkflowShowCommand() {
+    return new Command('show')
+        .description('Show workflow details and contract notes')
+        .argument('<name>', 'Workflow name')
+        .action(function (name) {
+        const globalOpts = GlobalOptionsSchema.parse(this.optsWithGlobals());
+        const { eventsDbPath, cacheDbPath } = resolveDbPaths(globalOpts.db);
+        const services = initializeDb({ eventsDbPath, cacheDbPath });
+        try {
+            runWorkflowShow({ services, name, json: globalOpts.json ?? false });
+        }
+        catch (error) {
+            handleError(error, globalOpts.json);
+        }
+        finally {
+            closeDb(services);
+        }
+    });
+}
+//# sourceMappingURL=show.js.map

package/dist/commands/workflow/show.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"show.js","sourceRoot":"","sources":["../../../src/commands/workflow/show.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AA0EzC,wBAAgB,SAAS,IAAI,OAAO,CAInC;AAiCD,wBAAgB,gBAAgB,IAAI,MAAM,CAMzC;AAED,wBAAgB,aAAa,IAAI,MAAM,CAOtC;AASD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAW1D;AAED,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,KAAK,CAAC;AAExE,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,yBAA0B,SAAQ,eAAe;IAChE,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,wBAAgB,wBAAwB,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,UAAU,GAAE,MAAwB,GAAG,yBAAyB,CA6D5H;AAED,wBAAgB,cAAc,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,UAAU,GAAE,MAAwB,GAAG,eAAe,CAGxG;AAED,wBAAgB,UAAU,CAAC,UAAU,GAAE,MAAwB,GAAG,MAAM,CAavE;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAKtD;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,UAAU,GAAE,MAAwB,GAAG,IAAI,CAuChG;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAiBxE"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAgFzC,wBAAgB,SAAS,IAAI,OAAO,CAInC;AAiCD,wBAAgB,gBAAgB,IAAI,MAAM,CAMzC;AAED,wBAAgB,aAAa,IAAI,MAAM,CAOtC;AASD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAW1D;AAED,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,KAAK,CAAC;AAExE,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,yBAA0B,SAAQ,eAAe;IAChE,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,wBAAgB,wBAAwB,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,UAAU,GAAE,MAAwB,GAAG,yBAAyB,CA6D5H;AAED,wBAAgB,cAAc,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,UAAU,GAAE,MAAwB,GAAG,eAAe,CAGxG;AAED,wBAAgB,UAAU,CAAC,UAAU,GAAE,MAAwB,GAAG,MAAM,CAiBvE;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAKtD;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,UAAU,GAAE,MAAwB,GAAG,IAAI,CAuChG;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAiBxE"}

package/dist/config.js

@@ -25,6 +25,12 @@ const ConfigFileSchema = z.object({
         }).optional(),
     }).optional(),
     dbPath: z.string().optional(),
+    hooks: z.object({
+        on_done: z.object({
+            url: z.string().optional(),
+            headers: z.record(z.string(), z.string()).optional(),
+        }).optional(),
+    }).optional(),
     defaultProject: z.string().optional(),
     defaultAuthor: z.string().optional(),
     leaseMinutes: z.number().positive().optional(),
@@ -212,7 +218,10 @@ export function readConfig(configPath = getConfigPath()) {
     try {
         const parsed = JSON.parse(content);
         const result = ConfigFileSchema.safeParse(parsed);
-        return result.success ? result.data : {};
+        if (!result.success) {
+            return {};
+        }
+        return result.data;
     }
     catch {
         throw new Error(`Config file at ${configPath} is invalid JSON`);