Add configuration file support for CLI

CHANGES.md

@@ -222,7 +222,19 @@ To be released.
     to the existing `-s`/`--service` option in `fedify tunnel` for consistency.
     [[#525], [#529], [#531] by Jiwon Kwon]
 
+ -  Added configuration file support for persisting CLI options.
+    [[#265], [#562] by Jiwon Kwon]
+
+     -  Configuration files are loaded hierarchically from system, user, and
+        project directories.
+     -  Added `--config` (`-C`) option to specify a custom configuration file
+        path.
+     -  Added `--ignore-config` option to skip loading configuration files.
+     -  Configuration options are now bound to commands: `lookup`, `webfinger`,
+        `tunnel`, `relay`, `inbox`, and `nodeinfo`.
+
 [Elysia]: https://elysiajs.com/
+[#265]: https://github.com/fedify-dev/fedify/issues/265
 [#374]: https://github.com/fedify-dev/fedify/issues/374
 [#397]: https://github.com/fedify-dev/fedify/issues/397
 [#408]: https://github.com/fedify-dev/fedify/issues/408
@@ -238,6 +250,7 @@ To be released.
 [#525]: https://github.com/fedify-dev/fedify/issues/525
 [#529]: https://github.com/fedify-dev/fedify/pull/529
 [#531]: https://github.com/fedify-dev/fedify/pull/531
+[#562]: https://github.com/fedify-dev/fedify/pull/562
 
 ### @fedify/debugger
 

docs/cli.md

@@ -102,6 +102,104 @@ the appropriate executable for your platform and put it in your `PATH`.
 [releases]: https://github.com/fedify-dev/fedify/releases
 
 
+Configuration file
+------------------
+
+*This feature is available since Fedify 2.0.0.*
+
+The `fedify` command supports configuration files to set default values for
+command options.  Configuration files are written in [TOML] format.
+
+[TOML]: https://toml.io/
+
+### Configuration file locations
+
+Configuration files are loaded from the following locations in order, with
+later files taking precedence over earlier ones:
+
+1.  `/etc/fedify/config.toml` (system-wide)
+2.  *<user-config-dir>/fedify/config.toml* (user-level)
+3.  `.fedify.toml` in the current working directory (project-level)
+4.  Custom path via `--config` option (explicit)
+
+The user config directory varies by operating system:
+
+ -  **Linux**: *~/.config/fedify/config.toml*
+ -  **macOS**: *~/Library/Application Support/fedify/config.toml*
+ -  **Windows**: *%APPDATA%\\fedify\\config.toml*
+
+### `--config`: Load an additional configuration file
+
+You can specify an additional configuration file to load using the `--config`
+option:
+
+~~~~ sh
+fedify --config ./my-config.toml lookup @user@example.com
+~~~~
+
+This file is loaded after all standard configuration files and takes the
+highest precedence.
+
+### `--ignore-config`: Ignore all configuration files
+
+The `--ignore-config` option skips loading all configuration files.  This is
+useful for CI environments or when you want reproducible behavior:
+
+~~~~ sh
+fedify --ignore-config lookup @user@example.com
+~~~~
+
+### Configuration file structure
+
+Below is an example configuration file showing all available options:
+
+~~~~ toml
+# Global settings (apply to all commands)
+debug = false
+userAgent = "MyApp/1.0"
+tunnelService = "localhost.run"  # "localhost.run", "serveo.net", or "pinggy.io"
+
+[webfinger]
+allowPrivateAddress = false
+maxRedirection = 5
+
+[lookup]
+authorizedFetch = false
+firstKnock = "draft-cavage-http-signatures-12"  # or "rfc9421"
+traverse = false
+suppressErrors = false
+defaultFormat = "default"  # "default", "raw", "compact", or "expand"
+separator = "----"
+timeout = 30  # seconds
+
+[inbox]
+actorName = "Fedify Ephemeral Actor"
+actorSummary = "An ephemeral actor for testing purposes."
+authorizedFetch = false
+noTunnel = false
+follow = ["@user@example.com"]
+acceptFollow = ["*"]
+
+[relay]
+protocol = "mastodon"  # or "litepub"
+port = 8000
+name = "Fedify Relay"
+persistent = "/path/to/relay.db"  # optional, uses in-memory if not specified
+noTunnel = false
+acceptFollow = ["*"]
+rejectFollow = []
+
+[nodeinfo]
+raw = false
+bestEffort = false
+showFavicon = true
+showMetadata = false
+~~~~
+
+All configuration options are optional.  Command-line arguments always take
+precedence over configuration file values.
+
+
 `fedify init`: Initializing a Fedify project
 --------------------------------------------
 

packages/amqp/deno.json

@@ -17,7 +17,10 @@
     "pnpm-lock.yaml"
   ],
   "publish": {
-    "exclude": ["**/*.test.ts", "tsdown.config.ts"]
+    "exclude": [
+      "**/*.test.ts",
+      "tsdown.config.ts"
+    ]
   },
   "tasks": {
     "build": "pnpm build",

packages/cli/deno.json

@@ -8,30 +8,34 @@
     "@inquirer/prompts": "npm:@inquirer/prompts@^7.8.4",
     "@jimp/core": "npm:@jimp/core@^1.6.0",
     "@jimp/wasm-webp": "npm:@jimp/wasm-webp@^1.6.0",
-    "@optique/core": "jsr:@optique/core@^0.9.0",
-    "@optique/run": "jsr:@optique/run@^0.9.0",
+    "@optique/config": "jsr:@optique/config@^0.10.0-dev.355",
+    "@optique/core": "jsr:@optique/core@^0.10.0-dev.355",
+    "@optique/run": "jsr:@optique/run@^0.10.0-dev.355",
     "@poppanator/http-constants": "npm:@poppanator/http-constants@^1.1.1",
     "chalk": "npm:chalk@^5.6.2",
     "cli-table3": "npm:cli-table3@^0.6.5",
     "env-paths": "npm:env-paths@^3.0.0",
+    "es-toolkit": "npm:es-toolkit@^1.39.4",
     "fetch-mock": "npm:fetch-mock@^12.5.4",
     "hono": "jsr:@hono/hono@^4.8.3",
     "icojs": "npm:icojs@^0.19.5",
     "inquirer-toggle": "npm:inquirer-toggle@^1.0.1",
     "ora": "npm:ora@^8.2.0",
     "shiki": "npm:shiki@^1.6.4",
+    "smol-toml": "npm:smol-toml@^1.6.0",
     "srvx": "npm:srvx@^0.8.7",
+    "valibot": "npm:valibot@^1.2.0",
     "#kv": "./src/kv.node.ts"
   },
   "exclude": [
     "dist/",
     "fedify-cli-*.tar.xz",
     "fedify-cli-*.tgz",
-    "fedify-cli-*.zip"
+    "fedify-cli-*.zip",
+    "package.json",
+    "src/install.mjs",
+    "src/run.mjs"
   ],
-  "publish": {
-    "exclude": ["**/*.test.ts", "tsdown.config.ts", "scripts/"]
-  },
   "tasks": {
     "codegen": "deno task -f @fedify/vocab compile",
     "check": {

packages/cli/package.json

@@ -1,6 +1,45 @@
 {
   "name": "@fedify/cli",
   "version": "2.0.0",
+  "type": "module",
+  "files": [
+    "README.md",
+    "package.json",
+    "src/install.mjs",
+    "src/run.mjs"
+  ],
+  "bin": {
+    "fedify": "./dist/mod.js"
+  },
+  "scripts": {
+    "build:self": "tsdown",
+    "build": "pnpm --filter @fedify/cli... run build:self",
+    "prepack": "pnpm build",
+    "prepublish": "pnpm build",
+    "pretest": "pnpm build",
+    "test": "node --test --experimental-transform-types 'src/**/*.test.ts' '!src/init/test/**'",
+    "test-init": "deno task test-init",
+    "pretest:bun": "pnpm build",
+    "test:bun": "bun test",
+    "run": "pnpm build && node dist/mod.js",
+    "runi": "tsdown && node dist/mod.js",
+    "run:bun": "pnpm build && bun dist/mod.js",
+    "runi:bun": "tsdown && bun dist/mod.js"
+  },
+  "engines": {
+    "node": ">=20.0.0",
+    "bun": ">=1.2.0",
+    "denp": ">=2.0.0"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ],
   "description": "CLI toolchain for Fedify and debugging ActivityPub",
   "keywords": [
     "fedify",
@@ -27,15 +66,6 @@
     "url": "git+https://github.com/fedify-dev/fedify.git",
     "directory": "packages/cli"
   },
-  "type": "module",
-  "engines": {
-    "node": ">=20.0.0",
-    "bun": ">=1.2.0",
-    "denp": ">=2.0.0"
-  },
-  "bin": {
-    "fedify": "./dist/mod.js"
-  },
   "exports": "./dist/mod.js",
   "imports": {
     "#kv": {
@@ -59,8 +89,9 @@
     "@js-temporal/polyfill": "catalog:",
     "@logtape/file": "catalog:",
     "@logtape/logtape": "catalog:",
-    "@optique/core": "^0.9.0",
-    "@optique/run": "^0.9.0",
+    "@optique/config": "0.10.0-dev.355",
+    "@optique/core": "0.10.0-dev.355",
+    "@optique/run": "0.10.0-dev.355",
     "@poppanator/http-constants": "^1.1.1",
     "byte-encodings": "catalog:",
     "chalk": "^5.6.2",
@@ -77,27 +108,14 @@
     "jimp": "^1.6.0",
     "ora": "^8.2.0",
     "shiki": "^1.6.4",
-    "srvx": "^0.8.7"
+    "smol-toml": "^1.6.0",
+    "srvx": "^0.8.7",
+    "valibot": "^1.2.0"
   },
   "devDependencies": {
     "@types/bun": "catalog:",
     "@types/node": "catalog:",
     "tsdown": "catalog:",
     "typescript": "catalog:"
-  },
-  "scripts": {
-    "build:self": "tsdown",
-    "build": "pnpm --filter @fedify/cli... run build:self",
-    "prepack": "pnpm build",
-    "prepublish": "pnpm build",
-    "pretest": "pnpm build",
-    "test": "node --test --experimental-transform-types 'src/**/*.test.ts' '!src/init/test/**'",
-    "test-init": "deno task test-init",
-    "pretest:bun": "pnpm build",
-    "test:bun": "bun test",
-    "run": "pnpm build && node dist/mod.js",
-    "runi": "tsdown && node dist/mod.js",
-    "run:bun": "pnpm build && bun dist/mod.js",
-    "runi:bun": "tsdown && bun dist/mod.js"
   }
 }