@singbox-iac/cli 0.1.0

package/dist/modules/init/index.js

@@ -0,0 +1,41 @@
+import { constants } from "node:fs";
+import { access, mkdir, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+export async function initWorkspace(input) {
+    const configTemplatePath = path.join(input.examplesDir, "builder.config.yaml");
+    const rulesTemplatePath = path.join(input.examplesDir, "custom.rules.yaml");
+    const [configTemplate, rulesTemplate] = await Promise.all([
+        readFile(configTemplatePath, "utf8"),
+        readFile(rulesTemplatePath, "utf8"),
+    ]);
+    const renderedConfig = input.subscriptionUrl
+        ? configTemplate.replace('url: "https://example.com/subscription"', `url: "${escapeYamlDoubleQuotedString(input.subscriptionUrl)}"`)
+        : configTemplate;
+    const configWithRulesPath = renderedConfig.replace('userRulesFile: "~/.config/singbox-iac/rules/custom.rules.yaml"', `userRulesFile: "${escapeYamlDoubleQuotedString(input.rulesOutPath)}"`);
+    await writeIfAllowed(input.configOutPath, configWithRulesPath, input.force === true);
+    await writeIfAllowed(input.rulesOutPath, rulesTemplate, input.force === true);
+    return {
+        configPath: input.configOutPath,
+        rulesPath: input.rulesOutPath,
+    };
+}
+async function writeIfAllowed(filePath, content, force) {
+    if (!force && (await pathExists(filePath))) {
+        throw new Error(`Refusing to overwrite existing file: ${filePath}`);
+    }
+    await mkdir(path.dirname(filePath), { recursive: true });
+    await writeFile(filePath, content, "utf8");
+}
+async function pathExists(filePath) {
+    try {
+        await access(filePath, constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function escapeYamlDoubleQuotedString(value) {
+    return value.replaceAll("\\", "\\\\").replaceAll('"', '\\"');
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/init/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,IAAI,MAAM,WAAW,CAAC;AAe7B,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAyB;IAC3D,MAAM,kBAAkB,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,qBAAqB,CAAC,CAAC;IAC/E,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,mBAAmB,CAAC,CAAC;IAE5E,MAAM,CAAC,cAAc,EAAE,aAAa,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACxD,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;QACpC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;KACpC,CAAC,CAAC;IAEH,MAAM,cAAc,GAAG,KAAK,CAAC,eAAe;QAC1C,CAAC,CAAC,cAAc,CAAC,OAAO,CACpB,yCAAyC,EACzC,SAAS,4BAA4B,CAAC,KAAK,CAAC,eAAe,CAAC,GAAG,CAChE;QACH,CAAC,CAAC,cAAc,CAAC;IACnB,MAAM,mBAAmB,GAAG,cAAc,CAAC,OAAO,CAChD,gEAAgE,EAChE,mBAAmB,4BAA4B,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,CACvE,CAAC;IAEF,MAAM,cAAc,CAAC,KAAK,CAAC,aAAa,EAAE,mBAAmB,EAAE,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC;IACrF,MAAM,cAAc,CAAC,KAAK,CAAC,YAAY,EAAE,aAAa,EAAE,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC;IAE9E,OAAO;QACL,UAAU,EAAE,KAAK,CAAC,aAAa;QAC/B,SAAS,EAAE,KAAK,CAAC,YAAY;KAC9B,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,QAAgB,EAAE,OAAe,EAAE,KAAc;IAC7E,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,wCAAwC,QAAQ,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,MAAM,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AAC7C,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,4BAA4B,CAAC,KAAa;IACjD,OAAO,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;AAC/D,CAAC"}

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

@@ -0,0 +1,29 @@
+import type { BuilderConfig } from "../../config/schema.js";
+export interface CheckConfigInput {
+    readonly configPath: string;
+    readonly singBoxBinary?: string;
+}
+export interface ApplyConfigInput {
+    readonly stagingPath: string;
+    readonly livePath: string;
+    readonly backupPath?: string;
+    readonly singBoxBinary?: string;
+    readonly reload?: boolean;
+    readonly runtime?: BuilderConfig["runtime"]["reload"];
+}
+export interface RunConfigInput {
+    readonly configPath: string;
+    readonly singBoxBinary?: string;
+    readonly validateFirst?: boolean;
+}
+export interface CheckConfigResult {
+    readonly binaryPath: string;
+}
+export declare function checkConfig(input: CheckConfigInput): Promise<CheckConfigResult>;
+export declare function applyConfig(input: ApplyConfigInput): Promise<void>;
+export declare function runConfig(input: RunConfigInput): Promise<number>;
+export declare function reloadRuntime(input: {
+    readonly singBoxBinary?: string;
+    readonly runtime: BuilderConfig["runtime"]["reload"];
+}): Promise<void>;
+export declare function resolveSingBoxBinary(explicitPath?: string): Promise<string>;

package/dist/modules/manager/index.js

@@ -0,0 +1,133 @@
+import { spawn } from "node:child_process";
+import { constants } from "node:fs";
+import { access, copyFile, mkdir } from "node:fs/promises";
+import path from "node:path";
+export async function checkConfig(input) {
+    const binaryPath = await resolveSingBoxBinary(input.singBoxBinary);
+    await runCommand(binaryPath, ["check", "-c", input.configPath]);
+    return { binaryPath };
+}
+export async function applyConfig(input) {
+    const { binaryPath } = await checkConfig({
+        configPath: input.stagingPath,
+        ...(input.singBoxBinary ? { singBoxBinary: input.singBoxBinary } : {}),
+    });
+    await mkdir(path.dirname(input.livePath), { recursive: true });
+    if (input.backupPath && (await pathExists(input.livePath))) {
+        await mkdir(path.dirname(input.backupPath), { recursive: true });
+        await copyFile(input.livePath, input.backupPath);
+    }
+    await copyFile(input.stagingPath, input.livePath);
+    if (input.reload && input.runtime) {
+        await reloadSingBox({
+            kind: input.runtime.kind,
+            ...(input.runtime.processName ? { processName: input.runtime.processName } : {}),
+            ...(input.runtime.signal ? { signal: input.runtime.signal } : {}),
+            ...(input.runtime.command ? { command: input.runtime.command } : {}),
+            binaryPath,
+        });
+    }
+}
+export async function runConfig(input) {
+    const binaryPath = await resolveSingBoxBinary(input.singBoxBinary);
+    if (input.validateFirst !== false) {
+        await checkConfig({
+            configPath: input.configPath,
+            singBoxBinary: binaryPath,
+        });
+    }
+    return new Promise((resolve, reject) => {
+        const child = spawn(binaryPath, ["run", "-c", input.configPath], {
+            stdio: "inherit",
+        });
+        child.on("error", reject);
+        child.on("close", (code) => resolve(code ?? 0));
+    });
+}
+export async function reloadRuntime(input) {
+    const binaryPath = await resolveSingBoxBinary(input.singBoxBinary);
+    await reloadSingBox({
+        kind: input.runtime.kind,
+        ...(input.runtime.processName ? { processName: input.runtime.processName } : {}),
+        ...(input.runtime.signal ? { signal: input.runtime.signal } : {}),
+        ...(input.runtime.command ? { command: input.runtime.command } : {}),
+        binaryPath,
+    });
+}
+export async function resolveSingBoxBinary(explicitPath) {
+    const candidates = [
+        explicitPath,
+        process.env.SING_BOX_BIN,
+        path.resolve(process.cwd(), ".tools", "sing-box-1.13.4-darwin-arm64", "sing-box"),
+        ...resolvePathCandidates("sing-box"),
+    ].filter((candidate) => typeof candidate === "string" && candidate.length > 0);
+    for (const candidate of candidates) {
+        if (await isExecutable(candidate)) {
+            return candidate;
+        }
+    }
+    throw new Error("Unable to find a usable sing-box binary. Set SING_BOX_BIN or install sing-box on PATH.");
+}
+async function reloadSingBox(input) {
+    if (input.kind === "command") {
+        if (!input.command) {
+            throw new Error("Reload command was requested but no command was configured.");
+        }
+        await runCommand("/bin/sh", ["-lc", input.command]);
+        return;
+    }
+    if (!input.processName || !input.signal) {
+        throw new Error("Signal-based reload requires processName and signal.");
+    }
+    await runCommand("/usr/bin/killall", [`-${input.signal}`, input.processName]);
+}
+async function isExecutable(filePath) {
+    try {
+        await access(filePath, constants.X_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function pathExists(filePath) {
+    try {
+        await access(filePath, constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function resolvePathCandidates(commandName) {
+    return (process.env.PATH ?? "")
+        .split(path.delimiter)
+        .filter((entry) => entry.length > 0)
+        .map((entry) => path.join(entry, commandName))
+        .filter((candidate, index, items) => items.indexOf(candidate) === index);
+}
+async function runCommand(command, args) {
+    await new Promise((resolve, reject) => {
+        const child = spawn(command, args, {
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        let stdout = "";
+        let stderr = "";
+        child.stdout.on("data", (chunk) => {
+            stdout += chunk.toString();
+        });
+        child.stderr.on("data", (chunk) => {
+            stderr += chunk.toString();
+        });
+        child.on("error", reject);
+        child.on("close", (code) => {
+            if (code === 0) {
+                resolve();
+                return;
+            }
+            const details = [stdout.trim(), stderr.trim()].filter((value) => value.length > 0).join("\n");
+            reject(new Error(details || `Command failed: ${command} ${args.join(" ")}`));
+        });
+    });
+}
+//# sourceMappingURL=index.js.map

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

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

package/dist/modules/natural-language/index.d.ts

@@ -0,0 +1,54 @@
+import type { BuilderConfig } from "../../config/schema.js";
+import type { UserRouteRule } from "../user-rules/index.js";
+export interface NaturalLanguageGroupOverride {
+    readonly defaultTarget?: string;
+    readonly defaultNodePattern?: string;
+}
+export interface NaturalLanguageVerificationOverride {
+    readonly inbound?: "in-mixed" | "in-proxifier";
+    readonly domain?: string;
+    readonly domainSuffix?: string;
+    readonly expectedOutbound: string;
+}
+export interface NaturalLanguagePlan {
+    readonly beforeBuiltins: readonly UserRouteRule[];
+    readonly afterBuiltins: readonly UserRouteRule[];
+    readonly templateIds: readonly string[];
+    readonly notes: readonly string[];
+    readonly scheduleIntervalMinutes?: number;
+    readonly groupDefaults?: Partial<{
+        processProxy: NaturalLanguageGroupOverride;
+        aiOut: NaturalLanguageGroupOverride;
+        devCommonOut: NaturalLanguageGroupOverride;
+        stitchOut: NaturalLanguageGroupOverride;
+    }>;
+    readonly verificationOverrides?: readonly NaturalLanguageVerificationOverride[];
+}
+export declare function generateRulesFromPrompt(prompt: string): NaturalLanguagePlan;
+export declare function writeGeneratedRules(input: {
+    readonly filePath: string;
+    readonly plan: NaturalLanguagePlan;
+}): Promise<string>;
+export declare function renderGeneratedRules(plan: NaturalLanguagePlan): string;
+export declare function updateBuilderSchedule(input: {
+    readonly configPath: string;
+    readonly intervalMinutes: number;
+}): Promise<void>;
+export declare function updateBuilderAuthoring(input: {
+    readonly configPath: string;
+    readonly rulesPath?: string;
+    readonly intervalMinutes?: number;
+    readonly groupDefaults?: NaturalLanguagePlan["groupDefaults"];
+    readonly verificationOverrides?: NaturalLanguagePlan["verificationOverrides"];
+}): Promise<void>;
+export declare function renderUpdatedBuilderConfig(input: {
+    readonly rawConfig: string;
+    readonly rulesPath?: string;
+    readonly intervalMinutes?: number;
+    readonly groupDefaults?: NaturalLanguagePlan["groupDefaults"];
+    readonly verificationOverrides?: NaturalLanguagePlan["verificationOverrides"];
+}): string;
+export declare function applyPlanToBuilderConfig(config: BuilderConfig, input: {
+    readonly rulesPath: string;
+    readonly plan: NaturalLanguagePlan;
+}): BuilderConfig;