@singbox-iac/cli 0.1.4 → 0.1.6

package/README-en.md

@@ -62,7 +62,7 @@ The system has three layers:
 
 ```mermaid
 flowchart TD
-    A["User provides subscription URL + one sentence"] --> B["setup"]
+    A["User provides subscription URL + one sentence"] --> B["quickstart / setup --ready"]
     B --> C["Detect local environment<br/>macOS / sing-box / Chrome / AI CLI"]
     C --> D["Generate rules from intent"]
     D --> E["Sync local rule sets"]
@@ -158,24 +158,42 @@ singbox-iac --help
 
 ## Quick Start
 
+### Most users only need 3 commands
+
+```bash
+singbox-iac go '<subscription-url>' '<one-sentence intent>'
+singbox-iac use '<new routing sentence>'
+singbox-iac update
+```
+
+- `go`: first-time onboarding in one command
+- `use`: change policy later with one sentence and re-apply it
+- `update`: refresh the subscription and apply the latest config
+
+Everything else can be treated as advanced commands for debugging or fine-grained control.
+
 ### One-step onboarding
 
 ```bash
-singbox-iac setup \
+singbox-iac quickstart \
   --subscription-url 'your subscription URL' \
   --prompt 'GitHub and developer sites go through Hong Kong, Antigravity process traffic goes through the US, Gemini goes through Singapore, update every 30 minutes'
 ```
 
-`setup` will:
+`quickstart` will:
 
 - create `~/.config/singbox-iac/builder.config.yaml`
 - create `~/.config/singbox-iac/rules/custom.rules.yaml`
+- create `~/.config/singbox-iac/proxifier/` helper files
 - check local environment readiness
-- download default local `.srs` rule sets
+- use bundled default `.srs` rule sets and only sync extras when needed
 - turn one sentence into routing rules
 - build `~/.config/singbox-iac/generated/config.staging.json`
+- verify critical routes
+- publish the live config
+- install the recurring schedule
 
-For a more guided first-run path:
+If you want the more explicit onboarding command, you can still use:
 
 ```bash
 singbox-iac setup \
@@ -184,11 +202,10 @@ singbox-iac setup \
   --ready
 ```
 
-`--ready` additionally performs:
+The difference is simple:
 
-- route verification
-- live config publish
-- recurring schedule installation
+- `quickstart` is the shortest opinionated first-run path
+- `setup --ready` is better if you still want to control run/browser/Proxifier flags yourself
 
 ### Manual foreground run
 
@@ -204,7 +221,7 @@ Default local listeners:
 ### Day-to-day usage
 
 ```bash
-singbox-iac update --reload
+singbox-iac update
 ```
 
 That command performs:
@@ -213,7 +230,7 @@ That command performs:
 - build
 - verify
 - apply
-- optional reload
+- reload automatically when a `sing-box` process is already running
 
 ### Background schedule
 
@@ -223,6 +240,12 @@ singbox-iac schedule install
 
 ## Natural-Language Authoring
 
+If you only want to change the routing sentence and apply it immediately, use the shorter command:
+
+```bash
+singbox-iac use 'GitHub and developer sites go through Hong Kong, Gemini goes through Singapore'
+```
+
 For common cases, you do not need to learn raw `sing-box` JSON or even the DSL.
 
 Examples:
@@ -245,6 +268,30 @@ The authoring layer supports:
 - preview before writing
 - closed-loop update after rule generation
 
+## Proxifier Onboarding
+
+If your AI IDE, language server, or desktop app does not respect the normal system proxy path, use the generated Proxifier helper directory:
+
+```text
+~/.config/singbox-iac/proxifier/
+```
+
+It contains:
+
+- `README.md`
+- `proxy-endpoint.txt`
+- `custom-processes.txt`
+- `bundles/antigravity.txt`
+- `bundles/cursor.txt`
+- `bundles/developer-ai-cli.txt`
+- `all-processes.txt`
+
+If you only want to regenerate the Proxifier helper files:
+
+```bash
+singbox-iac proxifier scaffold --prompt 'Antigravity process traffic goes through the US and Cursor also uses a dedicated ingress'
+```
+
 ## How It Works With sing-box
 
 This project does not replace the `sing-box` core binary. It generates and manages `sing-box` configuration.
@@ -282,6 +329,7 @@ The project does not automatically upload subscription URLs to any remote servic
 ```bash
 singbox-iac init
 singbox-iac setup
+singbox-iac quickstart
 singbox-iac author
 singbox-iac build
 singbox-iac check
@@ -290,6 +338,8 @@ singbox-iac run
 singbox-iac verify
 singbox-iac update
 singbox-iac doctor
+singbox-iac proxifier bundles
+singbox-iac proxifier scaffold
 singbox-iac schedule install
 singbox-iac schedule remove
 singbox-iac templates list
@@ -300,6 +350,7 @@ singbox-iac templates list
 - [rules-dsl.md](./docs/rules-dsl.md)
 - [rule-templates.md](./docs/rule-templates.md)
 - [natural-language-authoring.md](./docs/natural-language-authoring.md)
+- [proxifier-onboarding.md](./docs/proxifier-onboarding.md)
 - [runtime-on-macos.md](./docs/runtime-on-macos.md)
 - [openspec/project.md](./openspec/project.md)
 

package/README.md

@@ -62,7 +62,7 @@ flowchart LR
 
 ```mermaid
 flowchart TD
-    A["用户提供订阅地址 + 一句话需求"] --> B["setup"]
+    A["用户提供订阅地址 + 一句话需求"] --> B["quickstart / setup --ready"]
     B --> C["检测本地环境<br/>macOS / sing-box / Chrome / AI CLI"]
     C --> D["根据意图生成规则"]
     D --> E["同步本地 rule set"]
@@ -158,24 +158,42 @@ singbox-iac --help
 
 ## 快速开始
 
+### 大多数用户只需要 3 个命令
+
+```bash
+singbox-iac go '<订阅地址>' '<一句话需求>'
+singbox-iac use '<新的需求描述>'
+singbox-iac update
+```
+
+- `go`：第一次安装时使用，一条命令完成初始化、验证、发布和定时任务准备
+- `use`：以后需求变化时使用，一句话改策略并重新应用
+- `update`：日常更新订阅并自动在运行中的 `sing-box` 上生效
+
+其余命令都可以理解为高级命令，主要用于调试、排障或更细粒度控制。
+
 ### 一步完成初始化
 
 ```bash
-singbox-iac setup \
+singbox-iac quickstart \
   --subscription-url '你的机场订阅地址' \
   --prompt 'GitHub 这类开发类走香港，Antigravity 进程级走美国，Gemini 走新加坡，每30分钟自动更新'
 ```
 
-`setup` 会自动：
+`quickstart` 会自动：
 
 - 生成 `~/.config/singbox-iac/builder.config.yaml`
 - 生成 `~/.config/singbox-iac/rules/custom.rules.yaml`
+- 生成 `~/.config/singbox-iac/proxifier/` 辅助文件
 - 检查本地环境
-- 下载默认本地 `.srs` 规则集
+- 使用包内内置的默认 `.srs` 规则集，并在需要时补充同步
 - 把一句自然语言转成路由规则
 - 构建 `~/.config/singbox-iac/generated/config.staging.json`
+- 验证关键路由
+- 发布 live config
+- 安装定时更新
 
-如果你希望首次安装时尽可能自动化，可以这样：
+如果你希望保留更细的步骤控制，也可以继续用：
 
 ```bash
 singbox-iac setup \
@@ -184,11 +202,10 @@ singbox-iac setup \
   --ready
 ```
 
-`--ready` 会额外执行：
+`setup --ready` 和 `quickstart` 的主要区别是：
 
-- 路由验证
-- 发布 live config
-- 安装定时更新
+- `quickstart` 更偏默认的一键上手
+- `setup --ready` 更适合你还想自己决定是否运行、是否开浏览器、是否写 Proxifier 辅助目录
 
 ### 前台运行测试
 
@@ -204,7 +221,7 @@ singbox-iac run
 ### 日常使用
 
 ```bash
-singbox-iac update --reload
+singbox-iac update
 ```
 
 这条命令会执行：
@@ -213,7 +230,7 @@ singbox-iac update --reload
 - build
 - verify
 - apply
-- optional reload
+- 如果检测到 `sing-box` 正在运行，则自动 reload
 
 ### 定时更新
 
@@ -223,6 +240,12 @@ singbox-iac schedule install
 
 ## 自然语言规则编写
 
+如果你只想“改一句话需求并立即生效”，推荐直接用更短的命令：
+
+```bash
+singbox-iac use 'GitHub 这类开发类都走香港，Gemini 走新加坡'
+```
+
 对于大多数场景，不需要手写 `sing-box` JSON，也不需要理解 DSL。
 
 示例：
@@ -245,6 +268,30 @@ singbox-iac author \
 - 写入前先 preview
 - 生成规则后直接闭环 update
 
+## Proxifier 上手
+
+如果你的 AI IDE、language server 或桌面应用不走系统代理，可以直接使用自动生成的 Proxifier 辅助目录：
+
+```text
+~/.config/singbox-iac/proxifier/
+```
+
+其中会包含：
+
+- `README.md`
+- `proxy-endpoint.txt`
+- `custom-processes.txt`
+- `bundles/antigravity.txt`
+- `bundles/cursor.txt`
+- `bundles/developer-ai-cli.txt`
+- `all-processes.txt`
+
+如果你只想重新生成这部分，不需要重跑全部 onboarding：
+
+```bash
+singbox-iac proxifier scaffold --prompt 'Antigravity 进程级走美国，Cursor 也走独立入口'
+```
+
 ## 它和 sing-box 是怎么配合的
 
 它不会替代 `sing-box` 内核本身，而是负责生成和维护 `sing-box` 配置。
@@ -282,6 +329,7 @@ singbox-iac author \
 ```bash
 singbox-iac init
 singbox-iac setup
+singbox-iac quickstart
 singbox-iac author
 singbox-iac build
 singbox-iac check
@@ -290,6 +338,8 @@ singbox-iac run
 singbox-iac verify
 singbox-iac update
 singbox-iac doctor
+singbox-iac proxifier bundles
+singbox-iac proxifier scaffold
 singbox-iac schedule install
 singbox-iac schedule remove
 singbox-iac templates list
@@ -300,6 +350,7 @@ singbox-iac templates list
 - [rules-dsl.md](./docs/rules-dsl.md)
 - [rule-templates.md](./docs/rule-templates.md)
 - [natural-language-authoring.md](./docs/natural-language-authoring.md)
+- [proxifier-onboarding.md](./docs/proxifier-onboarding.md)
 - [runtime-on-macos.md](./docs/runtime-on-macos.md)
 - [openspec/project.md](./openspec/project.md)
 

package/dist/cli/command-helpers.js

@@ -42,9 +42,9 @@ async function fileExists(filePath) {
 }
 function getDefaultConfigCandidates() {
     return [
+        getDefaultConfigPath(),
         path.resolve(process.cwd(), "builder.config.local.yaml"),
         path.resolve(process.cwd(), "builder.config.yaml"),
-        getDefaultConfigPath(),
     ];
 }
 export function resolvePackageRoot(moduleUrl) {

package/dist/cli/command-helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"command-helpers.js","sourceRoot":"","sources":["../../src/cli/command-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAOtD,MAAM,UAAU,mBAAmB;IACjC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,qBAAqB,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,OAAO,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,OAAO,EAAE,mBAAmB,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAA6B;IAE7B,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,OAAO,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,qBAAqB,EAAE,CAAC;IACjD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,UAAU,CAAC,UAAU,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB;IACzC,KAAK,MAAM,QAAQ,IAAI,0BAA0B,EAAE,EAAE,CAAC;QACpD,IAAI,MAAM,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/B,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,QAAgB;IACxC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,0BAA0B;IACjC,OAAO;QACL,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,2BAA2B,CAAC;QACxD,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,qBAAqB,CAAC;QAClD,oBAAoB,EAAE;KACvB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,SAAiB;IAClD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,SAAiB;IACpD,MAAM,iBAAiB,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IACnD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAClD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,QAAQ,SAAS,EAAE,CAAC,CAAC;AAClF,CAAC"}
+{"version":3,"file":"command-helpers.js","sourceRoot":"","sources":["../../src/cli/command-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAOtD,MAAM,UAAU,mBAAmB;IACjC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,qBAAqB,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,OAAO,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,OAAO,EAAE,mBAAmB,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAA6B;IAE7B,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,OAAO,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,qBAAqB,EAAE,CAAC;IACjD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,UAAU,CAAC,UAAU,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB;IACzC,KAAK,MAAM,QAAQ,IAAI,0BAA0B,EAAE,EAAE,CAAC;QACpD,IAAI,MAAM,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/B,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,QAAgB;IACxC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,0BAA0B;IACjC,OAAO;QACL,oBAAoB,EAAE;QACtB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,2BAA2B,CAAC;QACxD,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,qBAAqB,CAAC;KACnD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,SAAiB;IAClD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,SAAiB;IACpD,MAAM,iBAAiB,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IACnD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAClD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,QAAQ,SAAS,EAAE,CAAC,CAAC;AAClF,CAAC"}

package/dist/cli/commands/author.d.ts

@@ -1,2 +1,30 @@
 import type { Command } from "commander";
 export declare function registerAuthorCommand(program: Command): void;
+export declare function runAuthorFlow(options: AuthorCommandOptions): Promise<void>;
+interface AuthorCommandOptions {
+    readonly prompt: string;
+    readonly config?: string;
+    readonly provider?: "deterministic" | "auto" | "claude" | "exec";
+    readonly authorTimeoutMs?: string;
+    readonly execCommand?: string;
+    readonly execArg: string[];
+    readonly rulesOut?: string;
+    readonly subscriptionUrl?: string;
+    readonly subscriptionFile?: string;
+    readonly preview?: boolean;
+    readonly skipBuild?: boolean;
+    readonly update?: boolean;
+    readonly skipVerify?: boolean;
+    readonly reload?: boolean;
+    readonly livePath?: string;
+    readonly backupPath?: string;
+    readonly singBoxBin?: string;
+    readonly chromeBin?: string;
+    readonly installSchedule?: boolean;
+    readonly label: string;
+    readonly launchAgentsDir?: string;
+    readonly logsDir?: string;
+    readonly forceSchedule?: boolean;
+    readonly load?: boolean;
+}
+export {};

package/dist/cli/commands/author.js

@@ -9,7 +9,7 @@ import { findDefaultConfigPath, resolveBuilderConfig, resolveCliEntrypoint, } fr
 export function registerAuthorCommand(program) {
     program
         .command("author")
-        .description("Generate custom rules from a natural-language prompt, then optionally build and schedule.")
+        .description("Advanced rule authoring from a natural-language prompt.")
         .requiredOption("-p, --prompt <text>", "natural-language routing prompt")
         .option("-c, --config <path>", "path to builder config YAML")
         .option("--provider <provider>", "authoring provider: deterministic, auto, claude, exec")
@@ -35,89 +35,45 @@ export function registerAuthorCommand(program) {
         .option("-f, --force-schedule", "replace an existing LaunchAgent file when installing")
         .option("--no-load", "write the LaunchAgent without calling launchctl bootstrap")
         .action(async (options) => {
-        const [builderConfig, configPath] = await Promise.all([
-            resolveBuilderConfig(options),
-            options.config ? Promise.resolve(resolvePath(options.config)) : findDefaultConfigPath(),
-        ]);
-        if (!builderConfig || !configPath) {
-            throw new Error("author requires a builder config. Pass --config or run init first.");
-        }
-        if (options.update && options.skipBuild) {
-            throw new Error("author cannot use --update together with --skip-build.");
-        }
-        const planResult = await generateAuthoringPlan({
-            prompt: options.prompt,
+        await runAuthorFlow(options);
+    });
+}
+export async function runAuthorFlow(options) {
+    const [builderConfig, configPath] = await Promise.all([
+        resolveBuilderConfig(options),
+        options.config ? Promise.resolve(resolvePath(options.config)) : findDefaultConfigPath(),
+    ]);
+    if (!builderConfig || !configPath) {
+        throw new Error("author requires a builder config. Pass --config or run init first.");
+    }
+    if (options.update && options.skipBuild) {
+        throw new Error("author cannot use --update together with --skip-build.");
+    }
+    const planResult = await generateAuthoringPlan({
+        prompt: options.prompt,
+        config: builderConfig,
+        ...(options.provider ? { provider: options.provider } : {}),
+        ...(options.authorTimeoutMs ? { timeoutMs: Number.parseInt(options.authorTimeoutMs, 10) } : {}),
+        ...(options.execCommand ? { execCommand: options.execCommand } : {}),
+        ...(options.execArg.length > 0 ? { execArgs: options.execArg } : {}),
+    });
+    const plan = planResult.plan;
+    const rulesPath = options.rulesOut
+        ? resolvePath(options.rulesOut)
+        : builderConfig.rules.userRulesFile;
+    const effectiveConfig = applyPlanToBuilderConfig(builderConfig, {
+        rulesPath,
+        plan,
+    });
+    if (options.preview) {
+        const preview = await generateAuthoringPreview({
+            configPath,
             config: builderConfig,
-            ...(options.provider ? { provider: options.provider } : {}),
-            ...(options.authorTimeoutMs
-                ? { timeoutMs: Number.parseInt(options.authorTimeoutMs, 10) }
-                : {}),
-            ...(options.execCommand ? { execCommand: options.execCommand } : {}),
-            ...(options.execArg.length > 0 ? { execArgs: options.execArg } : {}),
-        });
-        const plan = planResult.plan;
-        const rulesPath = options.rulesOut
-            ? resolvePath(options.rulesOut)
-            : builderConfig.rules.userRulesFile;
-        const effectiveConfig = applyPlanToBuilderConfig(builderConfig, {
-            rulesPath,
             plan,
-        });
-        if (options.preview) {
-            const preview = await generateAuthoringPreview({
-                configPath,
-                config: builderConfig,
-                plan,
-                rulesPath,
-                ...(options.subscriptionFile ? { subscriptionFile: options.subscriptionFile } : {}),
-                ...(options.subscriptionUrl ? { subscriptionUrl: options.subscriptionUrl } : {}),
-                buildStaging: !options.skipBuild,
-            });
-            const lines = [
-                `Config: ${configPath}`,
-                `Rules: ${rulesPath}`,
-                `Provider requested: ${planResult.providerRequested}`,
-                `Provider used: ${planResult.providerUsed}`,
-                `Templates: ${plan.templateIds.length > 0 ? plan.templateIds.join(", ") : "(none)"}`,
-                `Generated rules: ${plan.beforeBuiltins.length + plan.afterBuiltins.length}`,
-                "Preview mode: no files were written.",
-            ];
-            if (plan.notes.length > 0) {
-                lines.push(`Notes: ${plan.notes.length}`);
-                lines.push(...plan.notes.map((note) => `- ${note}`));
-            }
-            if (options.installSchedule) {
-                lines.push("Schedule install: requested, but skipped in preview mode.");
-            }
-            if (options.update) {
-                lines.push("Live update: requested, but skipped in preview mode.");
-            }
-            lines.push("");
-            lines.push("Rules diff:");
-            lines.push(preview.rulesDiff.diff);
-            lines.push("");
-            lines.push("Builder config diff:");
-            lines.push(preview.configDiff.diff);
-            if (preview.stagingDiff) {
-                lines.push("");
-                lines.push("Staging config diff:");
-                lines.push(preview.stagingDiff.diff);
-            }
-            process.stdout.write(`${lines.join("\n")}\n`);
-            return;
-        }
-        await writeGeneratedRules({
-            filePath: rulesPath,
-            plan,
-        });
-        await updateBuilderAuthoring({
-            configPath,
             rulesPath,
-            ...(plan.scheduleIntervalMinutes ? { intervalMinutes: plan.scheduleIntervalMinutes } : {}),
-            ...(plan.groupDefaults ? { groupDefaults: plan.groupDefaults } : {}),
-            ...(plan.verificationOverrides
-                ? { verificationOverrides: plan.verificationOverrides }
-                : {}),
+            ...(options.subscriptionFile ? { subscriptionFile: options.subscriptionFile } : {}),
+            ...(options.subscriptionUrl ? { subscriptionUrl: options.subscriptionUrl } : {}),
+            buildStaging: !options.skipBuild,
         });
         const lines = [
             `Config: ${configPath}`,
@@ -126,58 +82,100 @@ export function registerAuthorCommand(program) {
             `Provider used: ${planResult.providerUsed}`,
             `Templates: ${plan.templateIds.length > 0 ? plan.templateIds.join(", ") : "(none)"}`,
             `Generated rules: ${plan.beforeBuiltins.length + plan.afterBuiltins.length}`,
+            "Preview mode: no files were written.",
         ];
         if (plan.notes.length > 0) {
             lines.push(`Notes: ${plan.notes.length}`);
             lines.push(...plan.notes.map((note) => `- ${note}`));
         }
         if (options.installSchedule) {
-            const intervalMinutes = plan.scheduleIntervalMinutes ?? effectiveConfig.schedule.intervalMinutes;
-            const schedule = await installLaunchdSchedule({
-                configPath,
-                intervalMinutes,
-                cliEntrypoint: resolveCliEntrypoint(import.meta.url),
-                label: options.label,
-                ...(options.launchAgentsDir
-                    ? { launchAgentsDir: resolvePath(options.launchAgentsDir) }
-                    : {}),
-                ...(options.logsDir ? { logsDir: resolvePath(options.logsDir) } : {}),
-                force: options.forceSchedule === true,
-                load: options.load !== false,
-            });
-            lines.push(`LaunchAgent: ${schedule.plistPath}`);
+            lines.push("Schedule install: requested, but skipped in preview mode.");
         }
         if (options.update) {
-            const updateResult = await runUpdate({
-                config: effectiveConfig,
-                ...(options.subscriptionFile ? { subscriptionFile: options.subscriptionFile } : {}),
-                ...(options.subscriptionUrl ? { subscriptionUrl: options.subscriptionUrl } : {}),
-                ...(options.livePath ? { livePath: resolvePath(options.livePath) } : {}),
-                ...(options.backupPath ? { backupPath: resolvePath(options.backupPath) } : {}),
-                ...(options.singBoxBin ? { singBoxBinary: resolvePath(options.singBoxBin) } : {}),
-                ...(options.chromeBin ? { chromeBinary: resolvePath(options.chromeBin) } : {}),
-                verify: !options.skipVerify,
-                ...(options.reload ? { reload: true } : {}),
-            });
-            lines.push(`Staging: ${updateResult.build.outputPath}`);
-            lines.push(updateResult.verification
-                ? `Verified scenarios: ${updateResult.verification.scenarios.filter((scenario) => scenario.passed).length}/${updateResult.verification.scenarios.length}`
-                : "Verified scenarios: skipped");
-            lines.push(`Live: ${updateResult.livePath}`);
-            if (updateResult.backupPath) {
-                lines.push(`Backup: ${updateResult.backupPath}`);
-            }
+            lines.push("Live update: requested, but skipped in preview mode.");
         }
-        else if (!options.skipBuild) {
-            const build = await buildConfigArtifact({
-                config: effectiveConfig,
-                ...(options.subscriptionFile ? { subscriptionFile: options.subscriptionFile } : {}),
-                ...(options.subscriptionUrl ? { subscriptionUrl: options.subscriptionUrl } : {}),
-            });
-            lines.push(`Staging: ${build.outputPath}`);
+        lines.push("");
+        lines.push("Rules diff:");
+        lines.push(preview.rulesDiff.diff);
+        lines.push("");
+        lines.push("Builder config diff:");
+        lines.push(preview.configDiff.diff);
+        if (preview.stagingDiff) {
+            lines.push("");
+            lines.push("Staging config diff:");
+            lines.push(preview.stagingDiff.diff);
         }
         process.stdout.write(`${lines.join("\n")}\n`);
+        return;
+    }
+    await writeGeneratedRules({
+        filePath: rulesPath,
+        plan,
+    });
+    await updateBuilderAuthoring({
+        configPath,
+        rulesPath,
+        ...(plan.scheduleIntervalMinutes ? { intervalMinutes: plan.scheduleIntervalMinutes } : {}),
+        ...(plan.groupDefaults ? { groupDefaults: plan.groupDefaults } : {}),
+        ...(plan.verificationOverrides ? { verificationOverrides: plan.verificationOverrides } : {}),
     });
+    const lines = [
+        `Config: ${configPath}`,
+        `Rules: ${rulesPath}`,
+        `Provider requested: ${planResult.providerRequested}`,
+        `Provider used: ${planResult.providerUsed}`,
+        `Templates: ${plan.templateIds.length > 0 ? plan.templateIds.join(", ") : "(none)"}`,
+        `Generated rules: ${plan.beforeBuiltins.length + plan.afterBuiltins.length}`,
+    ];
+    if (plan.notes.length > 0) {
+        lines.push(`Notes: ${plan.notes.length}`);
+        lines.push(...plan.notes.map((note) => `- ${note}`));
+    }
+    if (options.installSchedule) {
+        const intervalMinutes = plan.scheduleIntervalMinutes ?? effectiveConfig.schedule.intervalMinutes;
+        const schedule = await installLaunchdSchedule({
+            configPath,
+            intervalMinutes,
+            cliEntrypoint: resolveCliEntrypoint(import.meta.url),
+            label: options.label,
+            ...(options.launchAgentsDir ? { launchAgentsDir: resolvePath(options.launchAgentsDir) } : {}),
+            ...(options.logsDir ? { logsDir: resolvePath(options.logsDir) } : {}),
+            force: options.forceSchedule === true,
+            load: options.load !== false,
+        });
+        lines.push(`LaunchAgent: ${schedule.plistPath}`);
+    }
+    if (options.update) {
+        const updateResult = await runUpdate({
+            config: effectiveConfig,
+            ...(options.subscriptionFile ? { subscriptionFile: options.subscriptionFile } : {}),
+            ...(options.subscriptionUrl ? { subscriptionUrl: options.subscriptionUrl } : {}),
+            ...(options.livePath ? { livePath: resolvePath(options.livePath) } : {}),
+            ...(options.backupPath ? { backupPath: resolvePath(options.backupPath) } : {}),
+            ...(options.singBoxBin ? { singBoxBinary: resolvePath(options.singBoxBin) } : {}),
+            ...(options.chromeBin ? { chromeBinary: resolvePath(options.chromeBin) } : {}),
+            verify: !options.skipVerify,
+            ...(options.reload ? { reload: true } : {}),
+        });
+        lines.push(`Staging: ${updateResult.build.outputPath}`);
+        lines.push(updateResult.verification
+            ? `Verified scenarios: ${updateResult.verification.scenarios.filter((scenario) => scenario.passed).length}/${updateResult.verification.scenarios.length}`
+            : "Verified scenarios: skipped");
+        lines.push(`Live: ${updateResult.livePath}`);
+        if (updateResult.backupPath) {
+            lines.push(`Backup: ${updateResult.backupPath}`);
+        }
+        lines.push(`Reload: ${updateResult.reloaded ? "triggered" : "skipped"}`);
+    }
+    else if (!options.skipBuild) {
+        const build = await buildConfigArtifact({
+            config: effectiveConfig,
+            ...(options.subscriptionFile ? { subscriptionFile: options.subscriptionFile } : {}),
+            ...(options.subscriptionUrl ? { subscriptionUrl: options.subscriptionUrl } : {}),
+        });
+        lines.push(`Staging: ${build.outputPath}`);
+    }
+    process.stdout.write(`${lines.join("\n")}\n`);
 }
 function resolvePath(filePath) {
     return filePath.startsWith("/") ? filePath : path.resolve(process.cwd(), filePath);