@singbox-iac/cli 0.1.6 → 0.1.8

package/dist/modules/proxifier/index.js

@@ -1,61 +1,139 @@
 import { mkdir, writeFile } from "node:fs/promises";
 import path from "node:path";
+import YAML from "yaml";
 const bundleDefinitions = [
     {
         id: "antigravity",
         name: "Antigravity",
-        description: "Recommended process patterns for Google Antigravity and its language services.",
-        processes: [
-            "Antigravity.app",
-            "Antigravity",
-            "com.google.antigravity",
-            "*Antigravity*",
-            "language_server_macos_arm",
-            "antigravity-auto-updater",
-            "*antigravity*",
+        description: "Google Antigravity desktop app, helpers, and language services.",
+        targetInbound: "in-proxifier",
+        targetOutboundGroup: "Process-Proxy",
+        processMatchers: [
+            { processName: "Antigravity.app" },
+            { processName: "Antigravity" },
+            { bundleId: "com.google.antigravity" },
+            { processName: "*Antigravity*" },
+            { processName: "language_server_macos_arm" },
+            { processName: "antigravity-auto-updater" },
+            { processName: "*antigravity*" },
+        ],
+        notes: [
+            "Use this bundle when Antigravity or its language server does not honor the normal system proxy path.",
         ],
     },
     {
         id: "cursor",
         name: "Cursor",
-        description: "Common Cursor desktop and helper process names.",
-        processes: ["Cursor", "Cursor.app", "Cursor Helper", "cursor", "*cursor*"],
+        description: "Cursor desktop app and helper processes.",
+        targetInbound: "in-proxifier",
+        targetOutboundGroup: "Process-Proxy",
+        processMatchers: [
+            { processName: "Cursor" },
+            { processName: "Cursor.app" },
+            { processName: "Cursor Helper" },
+            { processName: "cursor" },
+            { processName: "*cursor*" },
+        ],
+    },
+    {
+        id: "vscode",
+        name: "VS Code",
+        description: "Visual Studio Code desktop app, helper processes, and CLI entrypoints.",
+        targetInbound: "in-proxifier",
+        targetOutboundGroup: "Process-Proxy",
+        processMatchers: [
+            { processName: "Visual Studio Code" },
+            { processName: "Code" },
+            { processName: "Code Helper" },
+            { bundleId: "com.microsoft.VSCode" },
+            { processName: "code" },
+        ],
+    },
+    {
+        id: "claude-code",
+        name: "Claude Code",
+        description: "Claude CLI and related coding-agent processes.",
+        targetInbound: "in-proxifier",
+        targetOutboundGroup: "Process-Proxy",
+        processMatchers: [{ processName: "claude" }, { processName: "claude-code" }],
+    },
+    {
+        id: "gemini-cli",
+        name: "Gemini CLI",
+        description: "Gemini CLI and related local agent processes.",
+        targetInbound: "in-proxifier",
+        targetOutboundGroup: "Process-Proxy",
+        processMatchers: [{ processName: "gemini" }, { processName: "gemini-cli" }],
+    },
+    {
+        id: "codex",
+        name: "Codex",
+        description: "Codex desktop or CLI agent processes.",
+        targetInbound: "in-proxifier",
+        targetOutboundGroup: "Process-Proxy",
+        processMatchers: [{ processName: "codex" }, { processName: "codex-cli" }],
+    },
+    {
+        id: "copilot-cli",
+        name: "Copilot CLI",
+        description: "GitHub Copilot CLI-style developer tooling processes.",
+        targetInbound: "in-proxifier",
+        targetOutboundGroup: "Process-Proxy",
+        processMatchers: [
+            { processName: "copilot" },
+            { processName: "github-copilot" },
+            { processName: "copilot-cli" },
+        ],
     },
     {
         id: "developer-ai-cli",
         name: "Developer AI CLI",
-        description: "Common developer-facing AI and coding tool process names.",
-        processes: [
-            "claude",
-            "codex",
-            "gemini",
-            "codebuddy",
-            "cbc",
-            "opencode",
-            "qoder",
-            "qodercli",
-            "trae",
+        description: "A convenience bundle for common coding-agent and AI CLI tools.",
+        targetInbound: "in-proxifier",
+        targetOutboundGroup: "Process-Proxy",
+        processMatchers: [
+            { processName: "claude" },
+            { processName: "codex" },
+            { processName: "gemini" },
+            { processName: "codebuddy" },
+            { processName: "cbc" },
+            { processName: "opencode" },
+            { processName: "qoder" },
+            { processName: "qodercli" },
+            { processName: "trae" },
+        ],
+        notes: [
+            "Use this bundle when you want a single catch-all process list for developer AI tools.",
         ],
     },
 ];
 const promptBundleAliases = {
     antigravity: ["antigravity", "google antigravity", "google.antigravity"],
     cursor: ["cursor"],
-    "developer-ai-cli": [
-        "claude",
-        "codex",
-        "gemini",
-        "codebuddy",
-        "opencode",
-        "qoder",
-        "trae",
-        "ai ide",
-        "ai cli",
-    ],
+    vscode: ["vscode", "vs code", "visual studio code", "code helper"],
+    "claude-code": ["claude code", "claude cli", "claude"],
+    "gemini-cli": ["gemini cli", "gemini"],
+    codex: ["codex"],
+    "copilot-cli": ["copilot cli", "copilot"],
+    "developer-ai-cli": ["ai ide", "ai cli", "coding agent", "developer ai"],
 };
 export function listProxifierBundles() {
     return bundleDefinitions;
 }
+export function getProxifierBundle(id) {
+    return bundleDefinitions.find((bundle) => bundle.id === id);
+}
+export function renderProxifierBundleSpec(bundle) {
+    return YAML.stringify({
+        id: bundle.id,
+        name: bundle.name,
+        description: bundle.description,
+        targetInbound: bundle.targetInbound,
+        targetOutboundGroup: bundle.targetOutboundGroup,
+        processMatchers: bundle.processMatchers,
+        ...(bundle.notes && bundle.notes.length > 0 ? { notes: [...bundle.notes] } : {}),
+    });
+}
 export function selectProxifierBundlesFromPrompt(prompt) {
     const normalized = prompt.toLowerCase();
     const matched = new Set();
@@ -77,7 +155,8 @@ export async function writeProxifierScaffold(input) {
     const bundles = resolveBundles(input.bundleIds);
     await mkdir(input.outputDir, { recursive: true });
     const bundlesDir = path.join(input.outputDir, "bundles");
-    await mkdir(bundlesDir, { recursive: true });
+    const specsDir = path.join(input.outputDir, "bundle-specs");
+    await Promise.all([mkdir(bundlesDir, { recursive: true }), mkdir(specsDir, { recursive: true })]);
     const guidePath = path.join(input.outputDir, "README.md");
     const proxyEndpointPath = path.join(input.outputDir, "proxy-endpoint.txt");
     const customProcessesPath = path.join(input.outputDir, "custom-processes.txt");
@@ -100,12 +179,19 @@ export async function writeProxifierScaffold(input) {
         "",
     ].join("\n"), "utf8");
     const bundlePaths = [];
+    const bundleSpecPaths = [];
     const combinedProcesses = new Set();
     for (const bundle of bundles) {
-        const filePath = path.join(bundlesDir, `${bundle.id}.txt`);
-        await writeFile(filePath, [`# ${bundle.name}`, `# ${bundle.description}`, ...bundle.processes, ""].join("\n"), "utf8");
-        bundlePaths.push(filePath);
-        for (const processName of bundle.processes) {
+        const bundlePath = path.join(bundlesDir, `${bundle.id}.txt`);
+        const bundleSpecPath = path.join(specsDir, `${bundle.id}.yaml`);
+        const processNames = collectDisplayProcessNames(bundle.processMatchers);
+        await Promise.all([
+            writeFile(bundlePath, [`# ${bundle.name}`, `# ${bundle.description}`, ...processNames, ""].join("\n"), "utf8"),
+            writeFile(bundleSpecPath, renderProxifierBundleSpec(bundle), "utf8"),
+        ]);
+        bundlePaths.push(bundlePath);
+        bundleSpecPaths.push(bundleSpecPath);
+        for (const processName of processNames) {
             combinedProcesses.add(processName);
         }
     }
@@ -118,6 +204,7 @@ export async function writeProxifierScaffold(input) {
         listener: input.listener,
         bundles,
         bundlePaths,
+        bundleSpecPaths,
         customProcessesPath,
         ...(combinedProcessesPath ? { combinedProcessesPath } : {}),
     }), "utf8");
@@ -128,6 +215,7 @@ export async function writeProxifierScaffold(input) {
         customProcessesPath,
         ...(combinedProcessesPath ? { combinedProcessesPath } : {}),
         bundlePaths,
+        bundleSpecPaths,
         bundles,
     };
 }
@@ -170,10 +258,13 @@ function renderGuide(input) {
         for (let index = 0; index < input.bundles.length; index += 1) {
             const bundle = input.bundles[index];
             const bundlePath = input.bundlePaths[index];
-            if (!bundle || !bundlePath) {
+            const bundleSpecPath = input.bundleSpecPaths[index];
+            if (!bundle || !bundlePath || !bundleSpecPath) {
                 continue;
             }
-            lines.push(`- \`${bundle.name}\`: \`${path.relative(path.dirname(input.customProcessesPath), bundlePath)}\``);
+            lines.push(`- \`${bundle.name}\`: processes \`${path.relative(path.dirname(input.customProcessesPath), bundlePath)}\`, spec \`${path.relative(path.dirname(input.customProcessesPath), bundleSpecPath)}\``);
+            lines.push(`  - inbound: \`${bundle.targetInbound}\``);
+            lines.push(`  - outbound: \`${bundle.targetOutboundGroup}\``);
         }
     }
     else {
@@ -181,4 +272,19 @@ function renderGuide(input) {
     }
     return `${lines.join("\n")}\n`;
 }
+function collectDisplayProcessNames(matchers) {
+    const values = new Set();
+    for (const matcher of matchers) {
+        if (matcher.processName) {
+            values.add(matcher.processName);
+        }
+        if (matcher.bundleId) {
+            values.add(`bundle:${matcher.bundleId}`);
+        }
+        if (matcher.pathRegex) {
+            values.add(`path:${matcher.pathRegex}`);
+        }
+    }
+    return [...values];
+}
 //# sourceMappingURL=index.js.map

package/dist/modules/proxifier/index.js.map

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

package/dist/modules/runtime-mode/index.d.ts

@@ -0,0 +1,18 @@
+import type { BuilderConfig } from "../../config/schema.js";
+import type { IntentIR } from "../../domain/intent.js";
+import type { RuntimeMode, RuntimeModeDefaults } from "../../domain/runtime-mode.js";
+interface RuntimeModeInferenceInput {
+    readonly phase: "onboarding" | "update";
+    readonly prompt?: string;
+    readonly intent?: IntentIR;
+    readonly config?: BuilderConfig;
+    readonly proxifierBundleIds?: readonly string[];
+    readonly runInForeground?: boolean;
+}
+interface RuntimeModeScenario {
+    readonly inbound: "in-mixed" | "in-proxifier";
+}
+export declare function inferRuntimeMode(input: RuntimeModeInferenceInput): RuntimeMode;
+export declare function getRuntimeModeDefaults(mode: RuntimeMode): RuntimeModeDefaults;
+export declare function selectVerificationScenariosForRuntimeMode<T extends RuntimeModeScenario>(mode: RuntimeMode, scenarios: readonly T[]): readonly T[];
+export {};

package/dist/modules/runtime-mode/index.js

@@ -0,0 +1,72 @@
+const processKeywords = [
+    "proxifier",
+    "进程级",
+    "process-level",
+    "process proxy",
+    "独立入口",
+    "独立的入口",
+];
+export function inferRuntimeMode(input) {
+    if (input.phase === "update") {
+        return "headless-daemon";
+    }
+    const prompt = input.prompt?.toLowerCase() ?? "";
+    const hasProcessPrompt = processKeywords.some((keyword) => prompt.includes(keyword));
+    const hasProcessIntent = (input.intent?.processPolicies.length ?? 0) > 0;
+    const hasProxifierBundles = (input.proxifierBundleIds?.length ?? 0) > 0;
+    const hasProxifierScenarios = input.config?.verification.scenarios.some((scenario) => scenario.inbound === "in-proxifier") ??
+        false;
+    if (hasProcessPrompt || hasProcessIntent || hasProxifierBundles || hasProxifierScenarios) {
+        return "process-proxy";
+    }
+    if (input.runInForeground === false) {
+        return "headless-daemon";
+    }
+    return "browser-proxy";
+}
+export function getRuntimeModeDefaults(mode) {
+    switch (mode) {
+        case "process-proxy":
+            return {
+                preferredListeners: ["proxifier", "mixed"],
+                dnsMode: "real-ip",
+                openVisibleBrowserByDefault: true,
+                visibleBrowserScenarioLimit: 4,
+                scheduleRecommended: true,
+            };
+        case "headless-daemon":
+            return {
+                preferredListeners: ["mixed"],
+                dnsMode: "real-ip",
+                openVisibleBrowserByDefault: false,
+                visibleBrowserScenarioLimit: 0,
+                scheduleRecommended: true,
+            };
+        default:
+            return {
+                preferredListeners: ["mixed"],
+                dnsMode: "real-ip",
+                openVisibleBrowserByDefault: true,
+                visibleBrowserScenarioLimit: 3,
+                scheduleRecommended: false,
+            };
+    }
+}
+export function selectVerificationScenariosForRuntimeMode(mode, scenarios) {
+    switch (mode) {
+        case "process-proxy":
+            return sortScenariosByInbound(scenarios, ["in-proxifier", "in-mixed"]);
+        case "headless-daemon":
+        case "browser-proxy": {
+            const mixedOnly = scenarios.filter((scenario) => scenario.inbound === "in-mixed");
+            return mixedOnly.length > 0 ? mixedOnly : sortScenariosByInbound(scenarios, ["in-mixed"]);
+        }
+        default:
+            return scenarios;
+    }
+}
+function sortScenariosByInbound(scenarios, priority) {
+    const rank = new Map(priority.map((value, index) => [value, index]));
+    return [...scenarios].sort((left, right) => (rank.get(left.inbound) ?? priority.length) - (rank.get(right.inbound) ?? priority.length));
+}
+//# sourceMappingURL=index.js.map

package/dist/modules/runtime-mode/index.js.map

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

package/dist/modules/transactions/index.d.ts

@@ -0,0 +1,20 @@
+import type { BuilderConfig } from "../../config/schema.js";
+import type { ApplyTransaction } from "../../domain/transaction.js";
+export interface ApplyWithTransactionInput {
+    readonly config: BuilderConfig;
+    readonly generatedPath: string;
+    readonly livePath: string;
+    readonly backupPath: string;
+    readonly verificationSummary: Record<string, unknown>;
+    readonly retainSnapshots?: number;
+    readonly apply: () => Promise<void>;
+}
+export interface RollbackInput {
+    readonly config: BuilderConfig;
+    readonly livePath?: string;
+    readonly afterRestore?: () => Promise<void>;
+}
+export declare function applyWithTransaction(input: ApplyWithTransactionInput): Promise<ApplyTransaction>;
+export declare function listTransactionHistory(config: BuilderConfig): Promise<readonly ApplyTransaction[]>;
+export declare function rollbackToPrevious(input: RollbackInput): Promise<ApplyTransaction>;
+export declare function resolveTransactionHistoryPath(config: BuilderConfig): string;

package/dist/modules/transactions/index.js

@@ -0,0 +1,150 @@
+import { constants } from "node:fs";
+import { access, copyFile, mkdir, readFile, readdir, rm, writeFile } from "node:fs/promises";
+import path from "node:path";
+export async function applyWithTransaction(input) {
+    const txId = createTxId();
+    const historyPath = resolveTransactionHistoryPath(input.config);
+    const snapshotsDir = resolveSnapshotsDir(input.config);
+    await mkdir(path.dirname(historyPath), { recursive: true });
+    await mkdir(snapshotsDir, { recursive: true });
+    const liveExists = await pathExists(input.livePath);
+    const snapshotPath = liveExists ? path.join(snapshotsDir, `${txId}.json`) : undefined;
+    if (snapshotPath) {
+        await copyFile(input.livePath, snapshotPath);
+    }
+    if (input.backupPath && liveExists) {
+        await mkdir(path.dirname(input.backupPath), { recursive: true });
+        await copyFile(input.livePath, input.backupPath);
+    }
+    const pending = {
+        txId,
+        generatedPath: input.generatedPath,
+        livePath: input.livePath,
+        backupPath: input.backupPath,
+        ...(snapshotPath ? { snapshotPath } : {}),
+        startedAt: new Date().toISOString(),
+        status: "pending",
+        verificationSummary: input.verificationSummary,
+    };
+    await appendTransaction(historyPath, pending);
+    try {
+        await input.apply();
+        const applied = {
+            ...pending,
+            completedAt: new Date().toISOString(),
+            status: "applied",
+        };
+        await replaceLatestTransaction(historyPath, applied);
+        await trimSnapshots(historyPath, snapshotsDir, input.retainSnapshots ?? 5);
+        return applied;
+    }
+    catch (error) {
+        if (snapshotPath && (await pathExists(snapshotPath))) {
+            await copyFile(snapshotPath, input.livePath);
+            const rolledBack = {
+                ...pending,
+                completedAt: new Date().toISOString(),
+                status: "rolled-back",
+                error: error instanceof Error ? error.message : String(error),
+            };
+            await replaceLatestTransaction(historyPath, rolledBack);
+        }
+        else {
+            const failed = {
+                ...pending,
+                completedAt: new Date().toISOString(),
+                status: "failed",
+                error: error instanceof Error ? error.message : String(error),
+            };
+            await replaceLatestTransaction(historyPath, failed);
+        }
+        throw error;
+    }
+}
+export async function listTransactionHistory(config) {
+    return (await loadTransactionLog(resolveTransactionHistoryPath(config))).entries;
+}
+export async function rollbackToPrevious(input) {
+    const config = input.config;
+    const livePath = input.livePath ?? config.output.livePath;
+    const historyPath = resolveTransactionHistoryPath(config);
+    const log = await loadTransactionLog(historyPath);
+    const previous = log.entries.find((entry) => entry.status === "applied" && entry.snapshotPath);
+    if (!previous?.snapshotPath) {
+        throw new Error("No previous snapshot is available for rollback.");
+    }
+    if (!(await pathExists(previous.snapshotPath))) {
+        throw new Error(`The previous snapshot is missing: ${previous.snapshotPath}`);
+    }
+    await mkdir(path.dirname(livePath), { recursive: true });
+    await copyFile(previous.snapshotPath, livePath);
+    if (input.afterRestore) {
+        await input.afterRestore();
+    }
+    const tx = {
+        txId: createTxId(),
+        generatedPath: previous.snapshotPath,
+        livePath,
+        backupPath: config.output.backupPath,
+        snapshotPath: previous.snapshotPath,
+        startedAt: new Date().toISOString(),
+        completedAt: new Date().toISOString(),
+        status: "rolled-back",
+        verificationSummary: {
+            rollbackTo: previous.txId,
+        },
+    };
+    await appendTransaction(historyPath, tx);
+    return tx;
+}
+export function resolveTransactionHistoryPath(config) {
+    return path.join(path.dirname(config.output.stagingPath), "transactions.json");
+}
+function resolveSnapshotsDir(config) {
+    return path.join(path.dirname(config.output.stagingPath), "snapshots");
+}
+async function loadTransactionLog(historyPath) {
+    if (!(await pathExists(historyPath))) {
+        return { version: 1, entries: [] };
+    }
+    return JSON.parse(await readFile(historyPath, "utf8"));
+}
+async function appendTransaction(historyPath, entry) {
+    const log = await loadTransactionLog(historyPath);
+    await writeFile(historyPath, `${JSON.stringify({ version: 1, entries: [entry, ...log.entries] }, null, 2)}\n`, "utf8");
+}
+async function replaceLatestTransaction(historyPath, entry) {
+    const log = await loadTransactionLog(historyPath);
+    const [, ...rest] = log.entries;
+    await writeFile(historyPath, `${JSON.stringify({ version: 1, entries: [entry, ...rest] }, null, 2)}\n`, "utf8");
+}
+async function trimSnapshots(historyPath, snapshotsDir, retainSnapshots) {
+    const log = await loadTransactionLog(historyPath);
+    const keep = new Set(log.entries
+        .filter((entry) => entry.snapshotPath)
+        .slice(0, retainSnapshots)
+        .map((entry) => entry.snapshotPath));
+    if (!(await pathExists(snapshotsDir))) {
+        return;
+    }
+    const files = await readdir(snapshotsDir);
+    await Promise.all(files.map(async (fileName) => {
+        const filePath = path.join(snapshotsDir, fileName);
+        if (!keep.has(filePath)) {
+            await rm(filePath, { force: true });
+        }
+    }));
+}
+async function pathExists(filePath) {
+    try {
+        await access(filePath, constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function createTxId() {
+    return `tx-${Date.now()}-${Math.random().toString(16).slice(2, 10)}`;
+}
+//# sourceMappingURL=index.js.map

package/dist/modules/transactions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/transactions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7F,OAAO,IAAI,MAAM,WAAW,CAAC;AA0B7B,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,KAAgC;IAEhC,MAAM,IAAI,GAAG,UAAU,EAAE,CAAC;IAC1B,MAAM,WAAW,GAAG,6BAA6B,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAChE,MAAM,YAAY,GAAG,mBAAmB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACvD,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,MAAM,KAAK,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE/C,MAAM,UAAU,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACpD,MAAM,YAAY,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACtF,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,QAAQ,CAAC,KAAK,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,KAAK,CAAC,UAAU,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACjE,MAAM,QAAQ,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,OAAO,GAAqB;QAChC,IAAI;QACJ,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,MAAM,EAAE,SAAS;QACjB,mBAAmB,EAAE,KAAK,CAAC,mBAAmB;KAC/C,CAAC;IACF,MAAM,iBAAiB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAE9C,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;QACpB,MAAM,OAAO,GAAqB;YAChC,GAAG,OAAO;YACV,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACrC,MAAM,EAAE,SAAS;SAClB,CAAC;QACF,MAAM,wBAAwB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACrD,MAAM,aAAa,CAAC,WAAW,EAAE,YAAY,EAAE,KAAK,CAAC,eAAe,IAAI,CAAC,CAAC,CAAC;QAC3E,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,YAAY,IAAI,CAAC,MAAM,UAAU,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC;YACrD,MAAM,QAAQ,CAAC,YAAY,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;YAC7C,MAAM,UAAU,GAAqB;gBACnC,GAAG,OAAO;gBACV,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACrC,MAAM,EAAE,aAAa;gBACrB,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC9D,CAAC;YACF,MAAM,wBAAwB,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;QAC1D,CAAC;aAAM,CAAC;YACN,MAAM,MAAM,GAAqB;gBAC/B,GAAG,OAAO;gBACV,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACrC,MAAM,EAAE,QAAQ;gBAChB,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC9D,CAAC;YACF,MAAM,wBAAwB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QACtD,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,MAAqB;IAErB,OAAO,CAAC,MAAM,kBAAkB,CAAC,6BAA6B,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;AACnF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,KAAoB;IAC3D,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC5B,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC;IAC1D,MAAM,WAAW,GAAG,6BAA6B,CAAC,MAAM,CAAC,CAAC;IAC1D,MAAM,GAAG,GAAG,MAAM,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC;IAE/F,IAAI,CAAC,QAAQ,EAAE,YAAY,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IACD,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,qCAAqC,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC;IAChF,CAAC;IAED,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,MAAM,QAAQ,CAAC,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAChD,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;QACvB,MAAM,KAAK,CAAC,YAAY,EAAE,CAAC;IAC7B,CAAC;IAED,MAAM,EAAE,GAAqB;QAC3B,IAAI,EAAE,UAAU,EAAE;QAClB,aAAa,EAAE,QAAQ,CAAC,YAAY;QACpC,QAAQ;QACR,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU;QACpC,YAAY,EAAE,QAAQ,CAAC,YAAY;QACnC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,MAAM,EAAE,aAAa;QACrB,mBAAmB,EAAE;YACnB,UAAU,EAAE,QAAQ,CAAC,IAAI;SAC1B;KACF,CAAC;IACF,MAAM,iBAAiB,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IACzC,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,MAAqB;IACjE,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,mBAAmB,CAAC,CAAC;AACjF,CAAC;AAED,SAAS,mBAAmB,CAAC,MAAqB;IAChD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC,CAAC;AACzE,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,WAAmB;IACnD,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC;QACrC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACrC,CAAC;IAED,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,CAAmB,CAAC;AAC3E,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,WAAmB,EAAE,KAAuB;IAC3E,MAAM,GAAG,GAAG,MAAM,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAClD,MAAM,SAAS,CACb,WAAW,EACX,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAChF,MAAM,CACP,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,wBAAwB,CACrC,WAAmB,EACnB,KAAuB;IAEvB,MAAM,GAAG,GAAG,MAAM,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAClD,MAAM,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC;IAChC,MAAM,SAAS,CACb,WAAW,EACX,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EACzE,MAAM,CACP,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,aAAa,CAC1B,WAAmB,EACnB,YAAoB,EACpB,eAAuB;IAEvB,MAAM,GAAG,GAAG,MAAM,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,IAAI,GAAG,CAClB,GAAG,CAAC,OAAO;SACR,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC;SACrC,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC;SACzB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,YAAsB,CAAC,CAChD,CAAC;IAEF,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC;QACtC,OAAO;IACT,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC;IAC1C,MAAM,OAAO,CAAC,GAAG,CACf,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;QAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;QACnD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxB,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACtC,CAAC;IACH,CAAC,CAAC,CACH,CAAC;AACJ,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,UAAU;IACjB,OAAO,MAAM,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;AACvE,CAAC"}

package/dist/modules/update/index.d.ts

@@ -19,5 +19,6 @@ export interface UpdateResult {
     readonly livePath: string;
     readonly backupPath?: string;
     readonly reloaded: boolean;
+    readonly transactionId: string;
 }
 export declare function runUpdate(input: RunUpdateInput): Promise<UpdateResult>;

package/dist/modules/update/index.js

@@ -1,6 +1,7 @@
 import { buildConfigArtifact } from "../build/index.js";
 import { applyConfig } from "../manager/index.js";
 import { shouldAutoReloadRuntime } from "../manager/index.js";
+import { applyWithTransaction } from "../transactions/index.js";
 import { assertVerificationReportPassed, verifyConfigRoutes, } from "../verification/index.js";
 export async function runUpdate(input) {
     const build = await buildConfigArtifact({
@@ -22,13 +23,27 @@ export async function runUpdate(input) {
     const livePath = input.livePath ?? input.config.output.livePath;
     const backupPath = input.backupPath ?? input.config.output.backupPath;
     const reloaded = input.reload ?? (await shouldAutoReloadRuntime(input.config.runtime.reload));
-    await applyConfig({
-        stagingPath: build.outputPath,
+    const transaction = await applyWithTransaction({
+        config: input.config,
+        generatedPath: build.outputPath,
         livePath,
-        ...(backupPath ? { backupPath } : {}),
-        ...(input.singBoxBinary ? { singBoxBinary: input.singBoxBinary } : {}),
-        reload: reloaded,
-        runtime: input.config.runtime.reload,
+        backupPath,
+        verificationSummary: verification
+            ? {
+                routeScenariosPassed: verification.scenarios.filter((scenario) => scenario.passed).length,
+                routeScenariosTotal: verification.scenarios.length,
+            }
+            : { routeScenariosSkipped: true },
+        apply: async () => {
+            await applyConfig({
+                stagingPath: build.outputPath,
+                livePath,
+                ...(backupPath ? { backupPath } : {}),
+                ...(input.singBoxBinary ? { singBoxBinary: input.singBoxBinary } : {}),
+                reload: reloaded,
+                runtime: input.config.runtime.reload,
+            });
+        },
     });
     return {
         build,
@@ -36,6 +51,7 @@ export async function runUpdate(input) {
         livePath,
         ...(backupPath ? { backupPath } : {}),
         reloaded,
+        transactionId: transaction.txId,
     };
 }
 //# sourceMappingURL=index.js.map