Add CLI flags for bun-worker configuration #20

Copilot · 2026-01-06T07:33:36Z

Add CLI flags to configure bun-worker settings

Summary

This PR adds CLI flag support to the bun-worker SDK using the cac library, providing a simple command-line interface for worker configuration.

Available CLI Flags

--concurrency, -c: Number of tasks to process concurrently (default: 10)
--database-path: SQLite database file path (overrides ABSURD_DATABASE_PATH environment variable)
--extension-path: Absurd-SQLite extension path (overrides ABSURD_DATABASE_EXTENSION_PATH environment variable)
--help, -h: Display help information

Implementation Details

Uses cac library for CLI parsing with proper help messages
Configuration exclusively through CLI flags and environment variables
Configuration priority: defaults → CLI flags
CLI parsing logic extracted to parseCliOptions() helper function for clean code organization
Simple, focused API with single parameter: run(setupFunction)
--help flag exits gracefully without requiring database configuration
All 77 tests passing
Security scan verification (CodeQL clean)

Usage

import run from "@absurd-sqlite/bun-worker";

await run((absurd) => {
  absurd.registerTask({ name: "hello" }, async (params) => {
    return { ok: true };
  });
});

# Run with custom concurrency
bun run worker.ts --concurrency 5

# Override database and extension paths
bun run worker.ts --database-path ./my.db --extension-path ./libabsurd.so

# Show help
bun run worker.ts --help

The implementation provides a focused CLI interface for essential options. All configuration is done via CLI flags or environment variables.

Original prompt

This section details on the original issue you should resolve

<issue_title>bun-worker should provide cli flags to configure the worker concurrency and other settings</issue_title>
<issue_description></issue_description>

Comments on the Issue (you are @copilot in this section)

Fixes bun-worker should provide cli flags to configure the worker concurrency and other settings #19

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

Co-authored-by: bcho <1975118+bcho@users.noreply.github.com>

bcho · 2026-01-06T08:06:20Z

sdks/bun-worker/package-lock.json

@@ -0,0 +1,741 @@
+{


@copilot we use bun in this package

Removed package-lock.json and added it to .gitignore. The package now properly uses bun.lock for dependency management. (bcf13ef)

bcho

@copilot

Co-authored-by: bcho <1975118+bcho@users.noreply.github.com>

Copilot · 2026-01-06T08:13:53Z

@copilot

Hi! How can I help? Could you please provide more details about what you'd like me to address?

bcho

@copilot

bcho · 2026-01-07T07:13:59Z

samples/bun-worker/README.md

@@ -0,0 +1,59 @@
+# Bun Worker Sample
+
+This sample demonstrates how to use the `@absurd-sqlite/bun-worker` SDK to create a worker that processes tasks.


remove this readme file

Removed samples/bun-worker/README.md (d77d116)

bcho · 2026-01-07T07:14:56Z

samples/bun-worker/src/index.ts

 configureBunSqlite();

+// The worker now supports CLI flags for configuration:
+// --concurrency (-c): Number of concurrent tasks (default: 10)


expose only --concurrency flag for now. Add two more flags for specifying the extension path and database path.

Updated to expose only --concurrency, --database, and --extension flags (d77d116)

bcho · 2026-01-07T07:15:13Z

sdks/bun-worker/README.md

 });
 ```
+
+## CLI Flags


remove this part

Removed the CLI Flags section from README (d77d116)

sdks/bun-worker/src/index.ts

- Remove samples/bun-worker/README.md - Use cac for CLI parsing with help messages - Expose only --concurrency, --database, and --extension flags - Remove extensive CLI documentation from SDK README - Update error messages and tests Co-authored-by: bcho <1975118+bcho@users.noreply.github.com>

bcho

@copilot

bcho · 2026-01-07T07:38:02Z

sdks/bun-worker/README.md

 });
 ```
+
+## Programmatic Configuration


remove this part

Removed the Programmatic Configuration section from README (697101b)

bcho · 2026-01-07T07:38:52Z

sdks/bun-worker/src/index.ts

+   * Whether to parse CLI flags for worker configuration.
+   * Defaults to true.
+   */
+  parseCliFlags?: boolean;


remove this option

Removed parseCliFlags option from RunOptions (697101b)

bcho · 2026-01-07T07:39:16Z

sdks/bun-worker/src/index.ts

+): Promise<void> {
+  const parseFlags = options?.parseCliFlags !== false;
+
+  let dbPath = process.env.ABSURD_DATABASE_PATH;


extract the options parsing to a helper function

Extracted CLI parsing to parseCliOptions() helper function (697101b)

bcho · 2026-01-07T07:39:52Z

sdks/bun-worker/src/index.ts

+      .option("-c, --concurrency <number>", "Number of tasks to process concurrently", {
+        default: 10,
+      })
+      .option("-d, --database <path>", "SQLite database file path")


use --database-path and --extension-path

Changed to --database-path and --extension-path (697101b)

- Remove parseCliFlags option from RunOptions - Extract CLI parsing to parseCliOptions helper function - Rename flags to --database-path and --extension-path - Remove Programmatic Configuration section from README - Update tests to remove parseCliFlags test case Co-authored-by: bcho <1975118+bcho@users.noreply.github.com>

bcho · 2026-01-07T08:00:59Z

sdks/bun-worker/src/index.ts

+/**
+ * Configuration options for the worker runtime.
+ */
+export interface RunOptions {


remove this options instead?

Removed RunOptions interface and the options parameter from run() function. Configuration is now only through CLI flags and environment variables. (715b562)

- Remove RunOptions interface and options parameter from run() - Worker configuration now only through CLI flags and defaults - Remove test for programmatic workerOptions configuration - Simplifies API surface to focus on CLI-based configuration Co-authored-by: bcho <1975118+bcho@users.noreply.github.com>

bcho

bun run src/index.ts -- --help
bun-worker

Usage:
  $ bun-worker <command> [options]

Options:
  -c, --concurrency <number>  Number of tasks to process concurrently (default: 10)
  --database-path <path>      SQLite database file path
  --extension-path <path>     Absurd-SQLite extension path
  -h, --help                  Display this message
6084 | }
6085 | async function run(setupFunction) {
6086 |   const cliOptions = parseCliOptions();
6087 |   const dbPath = cliOptions.dbPath || process.env.ABSURD_DATABASE_PATH;
6088 |   const extensionPath = cliOptions.extensionPath || process.env.ABSURD_DATABASE_EXTENSION_PATH;
6089 |     throw new Error("Database path is required. Set ABSURD_DATABASE_PATH environment variable or use --database-path flag.");
                 ^

when -h is being used, no stacktrace should be dump

bcho · 2026-01-08T05:22:56Z

@copilot no i mean when using --help the program is failing, we should not do that

When --help is used, cac displays help and sets the help option. Previously, the program would continue execution and fail with "Database path is required" error. Now it exits gracefully with exit code 0 after showing help. Co-authored-by: bcho <1975118+bcho@users.noreply.github.com>

Copilot · 2026-01-08T05:29:30Z

@copilot no i mean when using --help the program is failing, we should not do that

Fixed. The --help flag now exits gracefully with code 0 after displaying help, without requiring database configuration. (6139d53)

Initial plan

df49910

Copilot AI assigned Copilot and bcho Jan 6, 2026

Copilot started work on behalf of bcho January 6, 2026 07:34 View session

Copilot AI and others added 5 commits January 6, 2026 07:40

Add CLI flag support for bun-worker configuration

d48e25b

Co-authored-by: bcho <1975118+bcho@users.noreply.github.com>

Fix type checking issues and add CLI test

cb302d9

Co-authored-by: bcho <1975118+bcho@users.noreply.github.com>

Simplify CLI configuration tests and verify all tests pass

3f3b1f0

Co-authored-by: bcho <1975118+bcho@users.noreply.github.com>

Refactor CLI parsing with helper functions and better error messages

74d5ee0

Co-authored-by: bcho <1975118+bcho@users.noreply.github.com>

Add CLI flag usage documentation to sample

382903b

Co-authored-by: bcho <1975118+bcho@users.noreply.github.com>

Copilot AI changed the title ~~[WIP] Add CLI flags to configure worker concurrency and settings~~ Add CLI flags for bun-worker configuration Jan 6, 2026

Copilot AI requested a review from bcho January 6, 2026 07:52

Copilot finished work on behalf of bcho January 6, 2026 07:52

bcho reviewed Jan 6, 2026

View reviewed changes

Copilot started work on behalf of bcho January 6, 2026 08:06 View session

Remove package-lock.json and add it to .gitignore (use bun)

bcf13ef

Co-authored-by: bcho <1975118+bcho@users.noreply.github.com>

Copilot finished work on behalf of bcho January 6, 2026 08:12

Copilot AI requested a review from bcho January 6, 2026 08:12

Copilot started work on behalf of bcho January 6, 2026 08:13 View session

Copilot finished work on behalf of bcho January 6, 2026 08:14

bcho requested changes Jan 7, 2026

View reviewed changes

Copilot started work on behalf of bcho January 7, 2026 07:20 View session

Copilot AI requested a review from bcho January 7, 2026 07:30

Copilot finished work on behalf of bcho January 7, 2026 07:30

bcho requested changes Jan 7, 2026

View reviewed changes

Copilot started work on behalf of bcho January 7, 2026 07:40 View session

Copilot AI requested a review from bcho January 7, 2026 07:48

Copilot finished work on behalf of bcho January 7, 2026 07:48

bcho requested changes Jan 7, 2026

View reviewed changes

Copilot started work on behalf of bcho January 7, 2026 08:01 View session

Copilot finished work on behalf of bcho January 7, 2026 08:08

Copilot AI requested a review from bcho January 7, 2026 08:08

bcho requested changes Jan 8, 2026

View reviewed changes

Copilot started work on behalf of bcho January 8, 2026 05:17 View session

Copilot AI requested a review from bcho January 8, 2026 05:18

Copilot finished work on behalf of bcho January 8, 2026 05:18

Copilot started work on behalf of bcho January 8, 2026 05:23 View session

Copilot finished work on behalf of bcho January 8, 2026 05:30

bcho marked this pull request as ready for review January 8, 2026 05:34

bcho merged commit 4136e64 into main Jan 8, 2026
8 checks passed

bcho deleted the copilot/add-cli-flags-for-worker-concurrency branch January 8, 2026 05:37

		@@ -0,0 +1,59 @@
		# Bun Worker Sample

		This sample demonstrates how to use the `@absurd-sqlite/bun-worker` SDK to create a worker that processes tasks.

Add CLI flags for bun-worker configuration #20

Add CLI flags for bun-worker configuration #20

Uh oh!

Conversation

Copilot AI commented Jan 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Add CLI flags to configure bun-worker settings

Summary

Available CLI Flags

Implementation Details

Usage

Comments on the Issue (you are @copilot in this section)

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 6, 2026

Choose a reason for hiding this comment

Uh oh!

bcho left a comment

Choose a reason for hiding this comment

Uh oh!

Copilot AI commented Jan 6, 2026

Uh oh!

bcho left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 7, 2026

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 7, 2026

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 7, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

bcho left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 7, 2026

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 7, 2026

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 7, 2026

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 7, 2026

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 7, 2026

Choose a reason for hiding this comment

Uh oh!

bcho left a comment

Choose a reason for hiding this comment

Uh oh!

bcho commented Jan 8, 2026

Uh oh!

Copilot AI commented Jan 8, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Copilot AI commented Jan 6, 2026 •

edited

Loading