@lostgradient/weft 0.2.0

package/dist/cli/help-text.d.ts

@@ -0,0 +1,13 @@
+export declare const HELP_TEXT = "\nweft - Bun-native durable execution engine\n\nUsage: weft [command] [options]\n\nCommands:\n  serve           Start the Weft server (default)\n  doctor          Run diagnostics on the Weft database\n  conformance     Run RemoteWorker protocol conformance checks\n  schedule        Manage recurring schedules\n  timeline        Inspect workflow timeline and replay history\n  version:check   Check workflow version compatibility\n  validate        Lint workflow registrations for design-time anti-patterns\n  codegen         Generate TypeScript declarations from a registry snapshot\n  api             Inspect and invoke catalog operations on a running server\n  server          Inspect a running server's health and operation surface\n  workflow        List, inspect, start, signal, and cancel workflows on a server\n  tail            Stream a workflow's events as Server-Sent Events\n  completions     Generate or install shell completion scripts\n  version         Print the installed Weft version\n\nVersion (leading token only; a subcommand owns its own option line):\n  weft version | weft --version | weft -v   Print the installed Weft version\n\nServe Options:\n  -p, --port <port>           Server port (default: 7233)\n  -d, --database <path>       Database file path (default: ./weft.db)\n  -s, --storage <backend>     Storage backend: sqlite, lmdb, memory (default: sqlite)\n  -w, --workflows <path>      Path to workflow module to register on startup\n  -h, --help                  Show this help message\n";
+export declare const API_HELP_TEXT = "\nweft api - Inspect and invoke catalog operations on a running server\n\nUsage:\n  weft api --list [options]\n  weft api --describe <operation-name> [options]\n  weft api <operation-name> [--input <json> | --input-file <path|->] [options]\n\nOptions:\n      --server <url>       Server URL (default: WEFT_ADDR, profile, run lockfile, or localhost)\n      --token <token>      Bearer token (default: WEFT_TOKEN)\n      --profile <name>     Profile from ~/.weft/config (default: WEFT_PROFILE or default_profile)\n      --input <json>       JSON object input for the operation\n      --input-file <path>  Read JSON object input from a file, or '-' for stdin\n      --list               List catalog operations\n      --describe <name>    Print one operation's schema and metadata\n      --yes                Confirm destructive operations without prompting\n  -j, --json               Emit machine-readable JSON output\n  -h, --help               Show this help message\n\nExit codes:\n  0   Success\n  1   Operation failed or destructive operation was not confirmed\n  2   Connection error\n  3   Usage or input validation error\n";
+export declare const CONFORMANCE_HELP_TEXT = "\nweft conformance - Run RemoteWorker protocol conformance checks\n\nUsage: weft conformance [options] -- <worker-command> [args...]\n\nThe worker command receives:\n  WEFT_WORKER_URL\n  WEFT_WORKER_QUEUE\n  WEFT_WORKER_ACTIVITIES\n  WEFT_WORKER_PROTOCOL_VERSION\n\nOptions:\n      --timeout <ms>       Per-check timeout in milliseconds (default: 15000)\n  -j, --json               Output results as JSON\n  -h, --help               Show this help message\n";
+export declare const DOCTOR_HELP_TEXT = "\nweft doctor - Run diagnostics on the Weft database\n\nUsage: weft doctor [options]\n\nOptions:\n  -d, --database <path>   Database file path (default: ./weft.db)\n  -j, --json              Output results as JSON\n  -h, --help              Show this help message\n";
+export declare const VERSION_CHECK_HELP_TEXT = "\nweft version:check - Check workflow version compatibility\n\nUsage: weft version:check [options]\n\nOptions:\n  -d, --database <path>     Database file path (default: ./weft.db)\n  -w, --workflows <path>    Path to workflows module\n  -j, --json                Output results as JSON\n  -h, --help                Show this help message\n";
+export declare const TIMELINE_HELP_TEXT = "\nweft timeline - Inspect workflow timeline and replay history\n\nUsage:\n  weft timeline <workflowId> [options]\n  weft timeline <workflowId> --diff <fromStep> <toStep> [options]\n\nOptions:\n  -d, --database <path>     Database file path (default: ./weft.db)\n      --step <step>         Show replay details for one checkpoint step\n      --diff                Diff two checkpoint steps (requires two positional step numbers)\n  -h, --help                Show this help message\n";
+export declare const SCHEDULE_HELP_TEXT = "\nweft schedule - Manage recurring schedules\n\nUsage:\n  weft schedule list [options]\n  weft schedule create <workflowType> <cronExpression> [options]\n  weft schedule create <workflowType> --every <duration> [options]\n  weft schedule pause <scheduleId> [options]\n  weft schedule resume <scheduleId> [options]\n  weft schedule cancel <scheduleId> [options]\n\nProvide a cron expression positional OR an --every interval (e.g. \"30s\", \"1h\"),\nbut not both. Interval schedules fire one period after creation, then every\nperiod after that.\n\nOptions:\n  -d, --database <path>     Database file path (default: ./weft.db)\n  -s, --storage <backend>   Storage backend: sqlite, lmdb (default: sqlite)\n  -w, --workflows <path>    Path to workflow registrations module (required for create)\n      --every <duration>    Interval cadence for create (e.g. 30s, 5m, 1h); mutually exclusive with the cron positional\n      --input <json>        JSON input payload for create (default: null)\n      --id <id>             Custom schedule id for create\n      --overlap <policy>    Overlap policy: skip, queue, cancel-running, allow\n      --backfill            Run missed ticks on recovery\n  -j, --json                Output results as JSON\n  -h, --help                Show this help message\n";
+export declare const VALIDATE_HELP_TEXT = "\nweft validate - Lint workflow registrations for design-time anti-patterns\n\nUsage: weft validate <entry.ts>... [options]\n\nArguments:\n  <entry.ts>...           One or more TypeScript modules or glob patterns that\n                          resolve to workflow registrations and/or activity\n                          definitions.\n\nOptions:\n  -j, --json              Output results as JSON\n  -h, --help              Show this help message\n\nExit codes:\n  0   No errors (warnings may be present)\n  1   One or more errors detected\n  2   Entry file could not be loaded (takes precedence over validation errors)\n\nJSON output:\n  { entries, valid, hasLoadErrors, hasValidationErrors }\n\nChecks performed:\n  unbounded-retry               Activity retry.maxAttempts is Infinity\n  stateful-without-compensator  Non-idempotent activity has no compensate fn\n";
+export declare const SERVER_HELP_TEXT = "\nweft server - Inspect a running server's health and operation surface\n\nUsage:\n  weft server health [options]\n  weft server info [options]\n\nOptions:\n      --server <url>       Server URL (default: WEFT_ADDR, profile, run lockfile, or localhost)\n      --token <token>      Bearer token (default: WEFT_TOKEN)\n      --profile <name>     Profile from ~/.weft/config\n      --wait               (health) Poll until the server is reachable\n      --wait-timeout <ms>  (health) Maximum time to wait, in milliseconds (default: 30000)\n  -j, --json               Emit machine-readable JSON output\n  -q, --quiet              Suppress success/error text (use the exit code)\n  -h, --help               Show this help message\n\nExit codes:\n  0   Healthy\n  1   Unreachable / unhealthy\n  2   Connection error\n";
+export declare const WORKFLOW_HELP_TEXT = "\nweft workflow - List, inspect, start, signal, and cancel workflows on a server\n\nUsage:\n  weft workflow ls [--type <type>] [--status <status>] [--limit <n>] [options]\n  weft workflow get <workflow-id> [options]\n  weft workflow events <workflow-id> [options]\n  weft workflow start <workflow-type> [--input <json> | --input-file <path|->] [--id <id>] [options]\n  weft workflow cancel <workflow-id> [--yes] [--dry-run] [options]\n  weft workflow signal <workflow-id> <signal-name> [--input <json> | --input-file <path|->] [options]\n\nOptions:\n      --server <url>       Server URL (default: WEFT_ADDR, profile, run lockfile, or localhost)\n      --token <token>      Bearer token (default: WEFT_TOKEN)\n      --profile <name>     Profile from ~/.weft/config\n      --type <type>        (ls) Filter by workflow type\n      --status <status>    (ls) Filter by workflow status\n      --limit <n>          (ls) Maximum number of rows\n      --input <json>       (start/signal) JSON input payload\n      --input-file <path>  (start/signal) Read JSON input from a file, or '-' for stdin\n      --id <id>            (start) Explicit workflow id\n  -y, --yes                (cancel) Confirm without prompting\n      --dry-run            (cancel) Print affected count without cancelling\n  -j, --json               Emit machine-readable output (NDJSON for lists)\n  -q, --quiet              Print ids only / suppress success text\n  -h, --help               Show this help message\n\nExit codes:\n  0   Success\n  1   Operation failed or destructive operation was not confirmed\n  2   Connection error\n  3   Usage or input error\n  4   Operation unavailable on this server (version skew)\n";
+export declare const TAIL_HELP_TEXT = "\nweft tail - Stream a workflow's events as Server-Sent Events\n\nUsage:\n  weft tail <workflow-id> [options]\n\nOptions:\n      --server <url>       Server URL (default: WEFT_ADDR, profile, run lockfile, or localhost)\n      --token <token>      Bearer token (default: WEFT_TOKEN)\n      --profile <name>     Profile from ~/.weft/config\n  -j, --json               Emit one JSON object per line (NDJSON)\n  -q, --quiet              Do not echo events to stdout\n  -h, --help               Show this help message\n\nPress Ctrl-C to stop tailing; the stream ends cleanly with exit code 0.\n";
+export declare const COMPLETIONS_HELP_TEXT = "\nweft completions - Generate or install shell completion scripts\n\nUsage:\n  weft completions generate --shell <zsh|bash|fish>\n  weft completions install --shell <zsh|bash|fish>\n\nOptions:\n      --shell <shell>      Target shell: zsh, bash, or fish (required)\n  -h, --help               Show this help message\n";
+export declare const CODEGEN_HELP_TEXT = "\nweft codegen - Generate TypeScript declarations from a registry snapshot\n\nUsage:\n  weft codegen --out <file> [options]\n  weft codegen --server <url> --out <file> [options]\n  weft codegen --from <path> --out <file> [options]\n\nReads a Weft registry snapshot (live HTTP fetch or a vendored JSON file) and\nemits a single deterministic .d.ts that augments the public 'weft' module\nwith typed entries for every registered workflow and activity. Subsequent\nruns with unchanged input do not rewrite the output file.\n\nOptions:\n      --server <url>     Base URL of a running Weft server. The CLI appends\n                         /api/v1/registry to whatever path you supply, so\n                         http://host/base becomes http://host/base/api/v1/registry\n      --from <path>      Read the registry snapshot from a local JSON file\n      --token <token>    Bearer token sent as Authorization header. Cannot be\n                         combined with --from\n  -o, --out <file>       Output .d.ts path. Parent directory must already exist\n      --timeout <ms>     Network timeout in milliseconds (default: 30000;\n                         must be a positive integer)\n  -j, --json             Emit a single JSON object on stdout for machine\n                         consumers; errors become {\"ok\":false,\"error\":...}\n                         on stderr\n  -h, --help             Show this help message\n\nConnection resolution:\n  Live HTTP fetches use --server and --token when provided, then WEFT_ADDR and\n  WEFT_TOKEN, then the ~/.weft/config profile, then the run lockfile written by\n  a local 'weft serve', then http://localhost:7233. Vendored snapshots supplied\n  with --from do not read connection settings.\n\nExit codes:\n  0   Success or no changes needed (file is up to date)\n  1   Validation, network, or filesystem error (no partial output written)\n";

package/dist/cli/help-text.js

@@ -0,0 +1,269 @@
+export const HELP_TEXT = `
+weft - Bun-native durable execution engine
+
+Usage: weft [command] [options]
+
+Commands:
+  serve           Start the Weft server (default)
+  doctor          Run diagnostics on the Weft database
+  conformance     Run RemoteWorker protocol conformance checks
+  schedule        Manage recurring schedules
+  timeline        Inspect workflow timeline and replay history
+  version:check   Check workflow version compatibility
+  validate        Lint workflow registrations for design-time anti-patterns
+  codegen         Generate TypeScript declarations from a registry snapshot
+  api             Inspect and invoke catalog operations on a running server
+  server          Inspect a running server's health and operation surface
+  workflow        List, inspect, start, signal, and cancel workflows on a server
+  tail            Stream a workflow's events as Server-Sent Events
+  completions     Generate or install shell completion scripts
+  version         Print the installed Weft version
+
+Version (leading token only; a subcommand owns its own option line):
+  weft version | weft --version | weft -v   Print the installed Weft version
+
+Serve Options:
+  -p, --port <port>           Server port (default: 7233)
+  -d, --database <path>       Database file path (default: ./weft.db)
+  -s, --storage <backend>     Storage backend: sqlite, lmdb, memory (default: sqlite)
+  -w, --workflows <path>      Path to workflow module to register on startup
+  -h, --help                  Show this help message
+`, API_HELP_TEXT = `
+weft api - Inspect and invoke catalog operations on a running server
+
+Usage:
+  weft api --list [options]
+  weft api --describe <operation-name> [options]
+  weft api <operation-name> [--input <json> | --input-file <path|->] [options]
+
+Options:
+      --server <url>       Server URL (default: WEFT_ADDR, profile, run lockfile, or localhost)
+      --token <token>      Bearer token (default: WEFT_TOKEN)
+      --profile <name>     Profile from ~/.weft/config (default: WEFT_PROFILE or default_profile)
+      --input <json>       JSON object input for the operation
+      --input-file <path>  Read JSON object input from a file, or '-' for stdin
+      --list               List catalog operations
+      --describe <name>    Print one operation's schema and metadata
+      --yes                Confirm destructive operations without prompting
+  -j, --json               Emit machine-readable JSON output
+  -h, --help               Show this help message
+
+Exit codes:
+  0   Success
+  1   Operation failed or destructive operation was not confirmed
+  2   Connection error
+  3   Usage or input validation error
+`, CONFORMANCE_HELP_TEXT = `
+weft conformance - Run RemoteWorker protocol conformance checks
+
+Usage: weft conformance [options] -- <worker-command> [args...]
+
+The worker command receives:
+  WEFT_WORKER_URL
+  WEFT_WORKER_QUEUE
+  WEFT_WORKER_ACTIVITIES
+  WEFT_WORKER_PROTOCOL_VERSION
+
+Options:
+      --timeout <ms>       Per-check timeout in milliseconds (default: 15000)
+  -j, --json               Output results as JSON
+  -h, --help               Show this help message
+`, DOCTOR_HELP_TEXT = `
+weft doctor - Run diagnostics on the Weft database
+
+Usage: weft doctor [options]
+
+Options:
+  -d, --database <path>   Database file path (default: ./weft.db)
+  -j, --json              Output results as JSON
+  -h, --help              Show this help message
+`, VERSION_CHECK_HELP_TEXT = `
+weft version:check - Check workflow version compatibility
+
+Usage: weft version:check [options]
+
+Options:
+  -d, --database <path>     Database file path (default: ./weft.db)
+  -w, --workflows <path>    Path to workflows module
+  -j, --json                Output results as JSON
+  -h, --help                Show this help message
+`, TIMELINE_HELP_TEXT = `
+weft timeline - Inspect workflow timeline and replay history
+
+Usage:
+  weft timeline <workflowId> [options]
+  weft timeline <workflowId> --diff <fromStep> <toStep> [options]
+
+Options:
+  -d, --database <path>     Database file path (default: ./weft.db)
+      --step <step>         Show replay details for one checkpoint step
+      --diff                Diff two checkpoint steps (requires two positional step numbers)
+  -h, --help                Show this help message
+`, SCHEDULE_HELP_TEXT = `
+weft schedule - Manage recurring schedules
+
+Usage:
+  weft schedule list [options]
+  weft schedule create <workflowType> <cronExpression> [options]
+  weft schedule create <workflowType> --every <duration> [options]
+  weft schedule pause <scheduleId> [options]
+  weft schedule resume <scheduleId> [options]
+  weft schedule cancel <scheduleId> [options]
+
+Provide a cron expression positional OR an --every interval (e.g. "30s", "1h"),
+but not both. Interval schedules fire one period after creation, then every
+period after that.
+
+Options:
+  -d, --database <path>     Database file path (default: ./weft.db)
+  -s, --storage <backend>   Storage backend: sqlite, lmdb (default: sqlite)
+  -w, --workflows <path>    Path to workflow registrations module (required for create)
+      --every <duration>    Interval cadence for create (e.g. 30s, 5m, 1h); mutually exclusive with the cron positional
+      --input <json>        JSON input payload for create (default: null)
+      --id <id>             Custom schedule id for create
+      --overlap <policy>    Overlap policy: skip, queue, cancel-running, allow
+      --backfill            Run missed ticks on recovery
+  -j, --json                Output results as JSON
+  -h, --help                Show this help message
+`, VALIDATE_HELP_TEXT = `
+weft validate - Lint workflow registrations for design-time anti-patterns
+
+Usage: weft validate <entry.ts>... [options]
+
+Arguments:
+  <entry.ts>...           One or more TypeScript modules or glob patterns that
+                          resolve to workflow registrations and/or activity
+                          definitions.
+
+Options:
+  -j, --json              Output results as JSON
+  -h, --help              Show this help message
+
+Exit codes:
+  0   No errors (warnings may be present)
+  1   One or more errors detected
+  2   Entry file could not be loaded (takes precedence over validation errors)
+
+JSON output:
+  { entries, valid, hasLoadErrors, hasValidationErrors }
+
+Checks performed:
+  unbounded-retry               Activity retry.maxAttempts is Infinity
+  stateful-without-compensator  Non-idempotent activity has no compensate fn
+`, SERVER_HELP_TEXT = `
+weft server - Inspect a running server's health and operation surface
+
+Usage:
+  weft server health [options]
+  weft server info [options]
+
+Options:
+      --server <url>       Server URL (default: WEFT_ADDR, profile, run lockfile, or localhost)
+      --token <token>      Bearer token (default: WEFT_TOKEN)
+      --profile <name>     Profile from ~/.weft/config
+      --wait               (health) Poll until the server is reachable
+      --wait-timeout <ms>  (health) Maximum time to wait, in milliseconds (default: 30000)
+  -j, --json               Emit machine-readable JSON output
+  -q, --quiet              Suppress success/error text (use the exit code)
+  -h, --help               Show this help message
+
+Exit codes:
+  0   Healthy
+  1   Unreachable / unhealthy
+  2   Connection error
+`, WORKFLOW_HELP_TEXT = `
+weft workflow - List, inspect, start, signal, and cancel workflows on a server
+
+Usage:
+  weft workflow ls [--type <type>] [--status <status>] [--limit <n>] [options]
+  weft workflow get <workflow-id> [options]
+  weft workflow events <workflow-id> [options]
+  weft workflow start <workflow-type> [--input <json> | --input-file <path|->] [--id <id>] [options]
+  weft workflow cancel <workflow-id> [--yes] [--dry-run] [options]
+  weft workflow signal <workflow-id> <signal-name> [--input <json> | --input-file <path|->] [options]
+
+Options:
+      --server <url>       Server URL (default: WEFT_ADDR, profile, run lockfile, or localhost)
+      --token <token>      Bearer token (default: WEFT_TOKEN)
+      --profile <name>     Profile from ~/.weft/config
+      --type <type>        (ls) Filter by workflow type
+      --status <status>    (ls) Filter by workflow status
+      --limit <n>          (ls) Maximum number of rows
+      --input <json>       (start/signal) JSON input payload
+      --input-file <path>  (start/signal) Read JSON input from a file, or '-' for stdin
+      --id <id>            (start) Explicit workflow id
+  -y, --yes                (cancel) Confirm without prompting
+      --dry-run            (cancel) Print affected count without cancelling
+  -j, --json               Emit machine-readable output (NDJSON for lists)
+  -q, --quiet              Print ids only / suppress success text
+  -h, --help               Show this help message
+
+Exit codes:
+  0   Success
+  1   Operation failed or destructive operation was not confirmed
+  2   Connection error
+  3   Usage or input error
+  4   Operation unavailable on this server (version skew)
+`, TAIL_HELP_TEXT = `
+weft tail - Stream a workflow's events as Server-Sent Events
+
+Usage:
+  weft tail <workflow-id> [options]
+
+Options:
+      --server <url>       Server URL (default: WEFT_ADDR, profile, run lockfile, or localhost)
+      --token <token>      Bearer token (default: WEFT_TOKEN)
+      --profile <name>     Profile from ~/.weft/config
+  -j, --json               Emit one JSON object per line (NDJSON)
+  -q, --quiet              Do not echo events to stdout
+  -h, --help               Show this help message
+
+Press Ctrl-C to stop tailing; the stream ends cleanly with exit code 0.
+`, COMPLETIONS_HELP_TEXT = `
+weft completions - Generate or install shell completion scripts
+
+Usage:
+  weft completions generate --shell <zsh|bash|fish>
+  weft completions install --shell <zsh|bash|fish>
+
+Options:
+      --shell <shell>      Target shell: zsh, bash, or fish (required)
+  -h, --help               Show this help message
+`, CODEGEN_HELP_TEXT = `
+weft codegen - Generate TypeScript declarations from a registry snapshot
+
+Usage:
+  weft codegen --out <file> [options]
+  weft codegen --server <url> --out <file> [options]
+  weft codegen --from <path> --out <file> [options]
+
+Reads a Weft registry snapshot (live HTTP fetch or a vendored JSON file) and
+emits a single deterministic .d.ts that augments the public 'weft' module
+with typed entries for every registered workflow and activity. Subsequent
+runs with unchanged input do not rewrite the output file.
+
+Options:
+      --server <url>     Base URL of a running Weft server. The CLI appends
+                         /api/v1/registry to whatever path you supply, so
+                         http://host/base becomes http://host/base/api/v1/registry
+      --from <path>      Read the registry snapshot from a local JSON file
+      --token <token>    Bearer token sent as Authorization header. Cannot be
+                         combined with --from
+  -o, --out <file>       Output .d.ts path. Parent directory must already exist
+      --timeout <ms>     Network timeout in milliseconds (default: 30000;
+                         must be a positive integer)
+  -j, --json             Emit a single JSON object on stdout for machine
+                         consumers; errors become {"ok":false,"error":...}
+                         on stderr
+  -h, --help             Show this help message
+
+Connection resolution:
+  Live HTTP fetches use --server and --token when provided, then WEFT_ADDR and
+  WEFT_TOKEN, then the ~/.weft/config profile, then the run lockfile written by
+  a local 'weft serve', then http://localhost:7233. Vendored snapshots supplied
+  with --from do not read connection settings.
+
+Exit codes:
+  0   Success or no changes needed (file is up to date)
+  1   Validation, network, or filesystem error (no partial output written)
+`;

package/dist/cli/index.d.ts

@@ -0,0 +1,23 @@
+#!/usr/bin/env bun
+export { removeRunLockfile, writeRunLockfile } from '../connection.ts';
+export { executeApi } from './api.ts';
+export { executeCodegen } from './codegen.ts';
+export { executeCompletions } from './completions.ts';
+export { executeConformance } from './conformance.ts';
+export { executeDoctor } from './doctor.ts';
+export { createWeftClient } from './generated/operation-client.generated.ts';
+export type { CatalogOperationName, WeftClient } from './generated/operation-client.generated.ts';
+export { API_HELP_TEXT, CODEGEN_HELP_TEXT, COMPLETIONS_HELP_TEXT, CONFORMANCE_HELP_TEXT, DOCTOR_HELP_TEXT, HELP_TEXT, SCHEDULE_HELP_TEXT, SERVER_HELP_TEXT, TAIL_HELP_TEXT, TIMELINE_HELP_TEXT, VALIDATE_HELP_TEXT, VERSION_CHECK_HELP_TEXT, WORKFLOW_HELP_TEXT, } from './help-text.ts';
+export { parseCliArguments } from './parse-arguments.ts';
+export { executeSchedule } from './schedule.ts';
+export { executeServer } from './server-commands.ts';
+export { createStorage } from './storage-factory.ts';
+export { findCliSubcommandName } from './subcommand-detection.ts';
+export { executeTail } from './tail.ts';
+export { executeTimeline } from './timeline.ts';
+export type { CliCommand, CommandOutput, StorageBackend } from './types.ts';
+export { collectDiffLines, splitGlobPattern } from './utilities.ts';
+export { executeValidate } from './validate.ts';
+export { executeVersionCheck } from './version-check.ts';
+export { executeVersion } from './version.ts';
+export { executeWorkflow } from './workflow-commands.ts';

package/dist/cli/index.js

@@ -0,0 +1,34 @@
+export { removeRunLockfile, writeRunLockfile } from "../connection.js";
+export { executeApi } from "./api.js";
+export { executeCodegen } from "./codegen.js";
+export { executeCompletions } from "./completions.js";
+export { executeConformance } from "./conformance.js";
+export { executeDoctor } from "./doctor.js";
+export { createWeftClient } from "./generated/operation-client.generated.js";
+export {
+  API_HELP_TEXT,
+  CODEGEN_HELP_TEXT,
+  COMPLETIONS_HELP_TEXT,
+  CONFORMANCE_HELP_TEXT,
+  DOCTOR_HELP_TEXT,
+  HELP_TEXT,
+  SCHEDULE_HELP_TEXT,
+  SERVER_HELP_TEXT,
+  TAIL_HELP_TEXT,
+  TIMELINE_HELP_TEXT,
+  VALIDATE_HELP_TEXT,
+  VERSION_CHECK_HELP_TEXT,
+  WORKFLOW_HELP_TEXT
+} from "./help-text.js";
+export { parseCliArguments } from "./parse-arguments.js";
+export { executeSchedule } from "./schedule.js";
+export { executeServer } from "./server-commands.js";
+export { createStorage } from "./storage-factory.js";
+export { findCliSubcommandName } from "./subcommand-detection.js";
+export { executeTail } from "./tail.js";
+export { executeTimeline } from "./timeline.js";
+export { collectDiffLines, splitGlobPattern } from "./utilities.js";
+export { executeValidate } from "./validate.js";
+export { executeVersionCheck } from "./version-check.js";
+export { executeVersion } from "./version.js";
+export { executeWorkflow } from "./workflow-commands.js";

package/dist/cli/json-rpc-client.d.ts

@@ -0,0 +1,15 @@
+import { type ConnectionOptions } from '../connection.ts';
+export type JsonRpcErrorObject = {
+    readonly code: number;
+    readonly message: string;
+    readonly data?: unknown;
+};
+export type JsonRpcCallResult = {
+    readonly ok: true;
+    readonly result: unknown;
+} | {
+    readonly ok: false;
+    readonly error: JsonRpcErrorObject;
+};
+export declare function sendJsonRpcRequest(connectionOptions: ConnectionOptions, method: string, params: unknown, id: string): Promise<JsonRpcCallResult>;
+export declare function jsonRpcEndpoint(server: URL): URL;

package/dist/cli/json-rpc-client.js

@@ -0,0 +1,37 @@
+import { resolveConnection } from "../connection.js";
+export async function sendJsonRpcRequest(connectionOptions, method, params, id) {
+  const connection = resolveConnection(connectionOptions), body = await (await fetch(jsonRpcEndpoint(connection.server), {
+    method: "POST",
+    headers: requestHeaders(connection.token),
+    body: JSON.stringify({
+      jsonrpc: "2.0",
+      method,
+      params,
+      id
+    })
+  })).json();
+  if (isJsonRpcError(body))
+    return { ok: !1, error: body.error };
+  if (isJsonRpcSuccess(body))
+    return { ok: !0, result: "result" in body ? body.result : void 0 };
+  throw Error(`Invalid JSON-RPC response from ${connection.server.toString()}`);
+}
+export function jsonRpcEndpoint(server) {
+  const endpoint = new URL(server.toString()), basePath = endpoint.pathname.endsWith("/") ? endpoint.pathname : `${endpoint.pathname}/`;
+  endpoint.pathname = `${basePath}jsonrpc`.replaceAll(/\/+/g, "/");
+  endpoint.search = "";
+  endpoint.hash = "";
+  return endpoint;
+}
+function requestHeaders(token) {
+  const headers = new Headers({ "content-type": "application/json" });
+  if (token !== void 0 && token !== "")
+    headers.set("authorization", `Bearer ${token}`);
+  return headers;
+}
+function isJsonRpcError(value) {
+  return typeof value === "object" && value !== null && "error" in value && typeof value.error === "object" && value.error !== null && "code" in value.error && typeof value.error.code === "number" && "message" in value.error && typeof value.error.message === "string";
+}
+function isJsonRpcSuccess(value) {
+  return typeof value === "object" && value !== null && "jsonrpc" in value && value.jsonrpc === "2.0" && "id" in value && !("error" in value);
+}

package/dist/cli/noun-verb-arguments.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Argument parsers for the hand-authored, server-facing noun-verb commands:
+ * `server`, `workflow`, `tail`, and `completions`. Each returns a typed
+ * {@link CliCommand} variant consumed by `cli-main.ts`.
+ *
+ * @module cli/noun-verb-arguments
+ */
+import type { CliCommand } from './types.ts';
+/** Parse `weft server health|info`. */
+export declare function parseServerArguments(args: string[]): CliCommand;
+export declare function parseWorkflowArguments(args: string[]): CliCommand;
+/** Parse `weft tail [workflow-id]`. */
+export declare function parseTailArguments(args: string[]): CliCommand;
+/** Parse `weft completions generate|install --shell <shell>`. */
+export declare function parseCompletionsArguments(args: string[]): CliCommand;

package/dist/cli/noun-verb-arguments.js

@@ -0,0 +1,190 @@
+import { parseArgs } from "node:util";
+const DEFAULT_WAIT_TIMEOUT_MS = 30000, VALID_COMPLETION_SHELLS = new Set(["zsh", "bash", "fish"]);
+function optionalField(key, value) {
+  return value === void 0 ? {} : { [key]: value };
+}
+const CONNECTION_OPTIONS = {
+  server: { type: "string" },
+  token: { type: "string" },
+  profile: { type: "string" },
+  help: { type: "boolean", short: "h", default: !1 },
+  json: { type: "boolean", short: "j", default: !1 },
+  quiet: { type: "boolean", short: "q", default: !1 }
+};
+function parsePositiveInteger(value, flag) {
+  if (value === void 0)
+    return;
+  const parsed = Number(value);
+  if (!Number.isSafeInteger(parsed) || parsed <= 0)
+    throw Error(`${flag} must be a positive integer`);
+  return parsed;
+}
+export function parseServerArguments(args) {
+  const { values, positionals } = parseArgs({
+    args,
+    options: {
+      ...CONNECTION_OPTIONS,
+      wait: { type: "boolean", default: !1 },
+      "wait-timeout": { type: "string" }
+    },
+    strict: !0,
+    allowPositionals: !0
+  }), action = positionals[0] ?? (values.help ? "health" : void 0);
+  if (action !== "health" && action !== "info")
+    throw Error("server: expected a subcommand: health or info");
+  const waitTimeoutMs = parsePositiveInteger(values["wait-timeout"], "--wait-timeout") ?? DEFAULT_WAIT_TIMEOUT_MS;
+  return {
+    command: "server",
+    action,
+    ...optionalField("server", values.server),
+    ...optionalField("token", values.token),
+    ...optionalField("profile", values.profile),
+    wait: values.wait ?? !1,
+    waitTimeoutMs,
+    help: values.help ?? !1,
+    json: values.json ?? !1,
+    quiet: values.quiet ?? !1
+  };
+}
+function parseWorkflowValues(args) {
+  return parseArgs({
+    args,
+    options: {
+      ...CONNECTION_OPTIONS,
+      type: { type: "string" },
+      status: { type: "string" },
+      limit: { type: "string" },
+      input: { type: "string" },
+      "input-file": { type: "string" },
+      id: { type: "string" },
+      yes: { type: "boolean", short: "y", default: !1 },
+      "dry-run": { type: "boolean", default: !1 }
+    },
+    strict: !0,
+    allowPositionals: !0
+  });
+}
+function workflowConnectionFields(values) {
+  return {
+    ...optionalField("server", values.server),
+    ...optionalField("token", values.token),
+    ...optionalField("profile", values.profile),
+    help: values.help ?? !1,
+    json: values.json ?? !1,
+    quiet: values.quiet ?? !1
+  };
+}
+const WORKFLOW_ACTION_BUILDERS = {
+  ls: (values) => ({
+    command: "workflow",
+    action: "ls",
+    ...workflowConnectionFields(values),
+    ...optionalField("type", values.type),
+    ...optionalField("status", values.status),
+    ...optionalField("limit", parsePositiveInteger(values.limit, "--limit"))
+  }),
+  get: (values, rest) => buildWorkflowGetOrEvents("get", values, rest),
+  events: (values, rest) => buildWorkflowGetOrEvents("events", values, rest),
+  start: (values, rest) => ({
+    command: "workflow",
+    action: "start",
+    ...workflowConnectionFields(values),
+    workflowType: requirePositional(rest[0], "workflow start", "<workflow-type>"),
+    ...optionalField("input", values.input),
+    ...optionalField("inputFile", values["input-file"]),
+    ...optionalField("id", values.id)
+  }),
+  cancel: (values, rest) => ({
+    command: "workflow",
+    action: "cancel",
+    ...workflowConnectionFields(values),
+    workflowId: requirePositional(rest[0], "workflow cancel", "<workflow-id>"),
+    yes: values.yes ?? !1,
+    dryRun: values["dry-run"] ?? !1
+  }),
+  signal: (values, rest) => ({
+    command: "workflow",
+    action: "signal",
+    ...workflowConnectionFields(values),
+    workflowId: requirePositional(rest[0], "workflow signal", "<workflow-id> <signal-name>"),
+    signalName: requirePositional(rest[1], "workflow signal", "<workflow-id> <signal-name>"),
+    ...optionalField("input", values.input),
+    ...optionalField("inputFile", values["input-file"])
+  })
+};
+function buildWorkflowGetOrEvents(action, values, rest) {
+  return {
+    command: "workflow",
+    action,
+    ...workflowConnectionFields(values),
+    workflowId: requirePositional(rest[0], `workflow ${action}`, "<workflow-id>")
+  };
+}
+export function parseWorkflowArguments(args) {
+  const { values, positionals } = parseWorkflowValues(args);
+  if (values.input !== void 0 && values["input-file"] !== void 0)
+    throw Error("workflow: --input and --input-file cannot be used together");
+  const action = positionals[0] ?? (values.help ? "ls" : ""), builder = WORKFLOW_ACTION_BUILDERS[action];
+  if (builder === void 0)
+    throw Error("workflow: expected a subcommand: ls, get, events, start, cancel, or signal");
+  if (values.help)
+    return { command: "workflow", action: "ls", ...workflowConnectionFields(values) };
+  return builder(values, positionals.slice(1));
+}
+export function parseTailArguments(args) {
+  const { values, positionals } = parseArgs({
+    args,
+    options: {
+      server: { type: "string" },
+      token: { type: "string" },
+      profile: { type: "string" },
+      help: { type: "boolean", short: "h", default: !1 },
+      json: { type: "boolean", short: "j", default: !1 },
+      quiet: { type: "boolean", short: "q", default: !1 }
+    },
+    strict: !0,
+    allowPositionals: !0
+  });
+  return {
+    command: "tail",
+    ...optionalField("server", values.server),
+    ...optionalField("token", values.token),
+    ...optionalField("profile", values.profile),
+    ...optionalField("workflowId", positionals[0]),
+    help: values.help ?? !1,
+    json: values.json ?? !1,
+    quiet: values.quiet ?? !1
+  };
+}
+function isCompletionShell(value) {
+  return VALID_COMPLETION_SHELLS.has(value);
+}
+function resolveCompletionShell(rawShell, isHelp) {
+  if (isHelp)
+    return rawShell !== void 0 && isCompletionShell(rawShell) ? rawShell : "zsh";
+  if (rawShell === void 0)
+    throw Error("completions: --shell is required (zsh, bash, or fish)");
+  if (!isCompletionShell(rawShell))
+    throw Error(`completions: unsupported shell '${rawShell}'. Must be one of: zsh, bash, fish`);
+  return rawShell;
+}
+export function parseCompletionsArguments(args) {
+  const { values, positionals } = parseArgs({
+    args,
+    options: {
+      shell: { type: "string" },
+      help: { type: "boolean", short: "h", default: !1 }
+    },
+    strict: !0,
+    allowPositionals: !0
+  }), isHelp = values.help ?? !1, action = positionals[0] ?? (isHelp ? "generate" : void 0);
+  if (action !== "generate" && action !== "install")
+    throw Error("completions: expected a subcommand: generate or install");
+  const shell = resolveCompletionShell(values.shell, isHelp);
+  return { command: "completions", action, shell, help: isHelp };
+}
+function requirePositional(value, command, usage) {
+  if (value === void 0 || value === "")
+    throw Error(`${command}: missing required argument. Usage: weft ${command} ${usage}`);
+  return value;
+}

package/dist/cli/operation-catalog-snapshot.d.ts

@@ -0,0 +1,38 @@
+import type { OperationKind, TransportAvailability } from '../server/operation-catalog.ts';
+import type { FaultCode } from '../server/operation-fault.ts';
+export type CatalogAccessSnapshot = {
+    readonly kind: 'public';
+} | {
+    readonly kind: 'authenticated';
+} | {
+    readonly kind: 'optionalAuth';
+    readonly scopes: ReadonlyArray<string>;
+} | {
+    readonly kind: 'scoped';
+    readonly scopes: ReadonlyArray<string>;
+} | {
+    readonly kind: 'scopedAlternatives';
+    readonly alternatives: ReadonlyArray<ReadonlyArray<string>>;
+};
+export type CatalogOperationSnapshot = {
+    readonly name: string;
+    readonly kind: OperationKind;
+    readonly summary: string;
+    /** Optional longer-form prose; present only for the interactive subset. */
+    readonly description?: string;
+    readonly tags: ReadonlyArray<string>;
+    readonly destructive: boolean;
+    readonly access: CatalogAccessSnapshot;
+    readonly transports: TransportAvailability;
+    readonly producibleFaults: ReadonlyArray<FaultCode>;
+    readonly inputSchema: Record<string, unknown>;
+    readonly outputSchema: Record<string, unknown>;
+    readonly eventSchema?: Record<string, unknown>;
+};
+export type CatalogSnapshot = {
+    readonly generatedBy: 'weft catalog snapshot';
+    readonly version: 1;
+    readonly operations: ReadonlyArray<CatalogOperationSnapshot>;
+};
+export declare function createCatalogSnapshot(): CatalogSnapshot;
+export declare function stringifyCatalogSnapshot(snapshot: CatalogSnapshot): string;